licenses_export_async_start
Initiate an async license export job, poll the returned ID for the finished file.
Instructions
Start an async license export job. Returns {export:{id}} to poll. accept=csv|json sets the format the eventual download will produce (the start response itself is always the id envelope).
📖 Spec (POST /rest/3/reporting/developer-space/{developerId}/licenses/async/export): https://developer.atlassian.com/platform/marketplace/rest/v4/api-group-reporting/#api-rest-3-reporting-developer-space-developerid-licenses-async-export-post
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Free-text search across identifiers: SEN, appEntitlementNumber (Cloud), appEntitlementId (UUID), cloudId, cloudSiteHostname, email, organization name. | |
| tier | No | ||
| limit | No | ||
| order | No | ||
| accept | No | Output format: `csv` (default for these exports — header-rowed CSV string) or `json` (array of records). Invalid → HTTP 400. | |
| offset | No | ||
| sortBy | No | ||
| status | No | ||
| endDate | No | ISO date YYYY-MM-DD | |
| hosting | No | Note: 'datacenter' is one word, not 'data_center'. Response objects use capitalized 'Cloud'/'Server'/'Data Center' but the filter param is lowercase one-word. | |
| dateType | No | ||
| productId | No | Product UUID (or comma-separated list). Use apps_list / apps_known to discover. | |
| startDate | No | ISO date YYYY-MM-DD | |
| appEdition | No | Filter by app edition (case-insensitive in practice but lowercase per Atlassian's error spec). | |
| lastUpdated | No | ISO datetime — licenses updated on/after this instant. | |
| licenseType | No | ||
| partnerType | No | ||
| licenseLevel | No | ||
| withAttribution | No | DEPRECATED by Atlassian; use withDataInsights instead. Both add evaluation/attribution fields when true. | |
| withDataInsights | No | Adds 10 extra fields to each license: evaluationOpportunitySize, evaluationLicense, daysToConvertEval, evaluationStartDate, evaluationEndDate, evaluationSaleDate, parentProductBillingCycle, parentProductName, installedOnSandbox, parentProductEdition. | |
| showLicensesHistory | No | If true, returns the full history of license events for matched SENs (multiple rows per license). Not formally in the swagger but the runtime API accepts it. | |
| includeAtlassianLicenses | No | If true, include internal Atlassian licenses in the result. | |
| showLifeTimeFreeLicenses | No | If true, scope the response to lifetime-free-tier licenses. If false (default), excludes them. | |
| cloudComplianceBoundaries | No | Cloud compliance boundary. Valid values: 'commercial' (default), 'fedramp_moderate', 'isolated_cloud'. **Cloud-hosted apps only — silently ignored for server/datacenter apps.** Defaults to 'commercial' when omitted on cloud apps. NOTE: This MCP currently accepts a single value; to query multiple boundaries make separate calls (probed 2026-06-01: comma-separated lists are silently mis-parsed by the API — only repeated-param form works server-side). |