licenses_list
Read-onlyIdempotent
List paginated licenses for a developer space. Filter by product, hosting, date range, or text search for a specific SEN.
Instructions
List licenses for the developer space (paginated, offset/limit). Use 'text' to find a single license by SEN.
📖 Spec (GET /rest/3/reporting/developer-space/{developerId}/licenses): https://developer.atlassian.com/platform/marketplace/rest/v4/api-group-reporting/#api-rest-3-reporting-developer-space-developerid-licenses-get
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 | ||
| 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). |