List Apps

Find and list apps in App Store Connect.

URL

GET https://api.appstoreconnect.apple.com/v1/apps

Query Parameters

Name	Type	Description
`fields[apps]` Optional	[string]	Fields to return for included related types.
`fields[betaLicenseAgreements]` Optional	[string]	Fields to return for included related types.
`filter[bundleId]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[id]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[name]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[sku]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`include` Optional	[string]	Relationship data to include in the response.
`limit` Optional	integer	Number of resources to return.
`sort` Optional	[string]	Attributes by which to sort.
`fields[preReleaseVersions]` Optional	[string]	Fields to return for included related types.
`limit[preReleaseVersions]` Optional	integer	Number of included related resources to return.
`fields[betaAppReviewDetails]` Optional	[string]	Fields to return for included related types.
`fields[betaAppLocalizations]` Optional	[string]	Fields to return for included related types.
`fields[builds]` Optional	[string]	Fields to return for included related types.
`fields[betaGroups]` Optional	[string]	Fields to return for included related types.
`limit[builds]` Optional	integer	Number of included related resources to return.
`limit[betaGroups]` Optional	integer	Number of included related resources to return.
`limit[betaAppLocalizations]` Optional	integer	Number of included related resources to return.
`limit[appStoreVersions]` Optional	integer
`limit[appInfos]` Optional	integer
`fields[endUserLicenseAgreements]` Optional	[string]	Fields to return for included related types.
`fields[appStoreVersions]` Optional	[string]	Fields to return for included related types. Note: `appStoreState` is deprecated, use `appVersionState` instead.
`fields[appInfos]` Optional	[string]	Fields to return for included related types.
`filter[appStoreVersions]` Optional	[string]	Fields to return for included related types.
`filter[appStoreVersions.platform]` Optional	[string]	Fields to return for included related types.
`filter[appStoreVersions.appStoreState]` Optional	[string]
`limit[gameCenterEnabledVersions]` Optional	integer
`fields[gameCenterEnabledVersions]` Optional	[string]	Fields to return for included related types.
`exists[gameCenterEnabledVersions]` Optional	boolean
`limit[inAppPurchases]` Optional	integer
`fields[inAppPurchases]` Optional	[string]	Fields to return for included related types.
`fields[ciProducts]` Optional	[string]	Fields to return for included related types.
`limit[appClips]` Optional	integer
`fields[appClips]` Optional	[string]
`fields[reviewSubmissions]` Optional	[string]
`fields[appCustomProductPages]` Optional	[string]
`fields[appEvents]` Optional	[string]
`limit[appCustomProductPages]` Optional	integer
`limit[appEvents]` Optional	integer
`limit[reviewSubmissions]` Optional	integer
`fields[subscriptionGracePeriods]` Optional	[string]
`fields[promotedPurchases]` Optional	[string]
`fields[subscriptionGroups]` Optional	[string]
`limit[inAppPurchasesV2]` Optional	integer
`limit[promotedPurchases]` Optional	integer
`limit[subscriptionGroups]` Optional	integer
`fields[appStoreVersionExperiments]` Optional	[string]
`limit[appStoreVersionExperimentsV2]` Optional	integer
`fields[appEncryptionDeclarations]` Optional	[string]
`limit[appEncryptionDeclarations]` Optional	integer
`fields[gameCenterDetails]` Optional	[string]
`filter[appStoreVersions.appVersionState]` Optional	[string]	This filter is deprecated.
`fields[androidToIosAppMappingDetails]` Optional	[string]
`filter[reviewSubmissions.platform]` Optional	[string]
`filter[reviewSubmissions.state]` Optional	[string]
`limit[androidToIosAppMappingDetails]` Optional	integer

Response Codes

Status	Reason	Type	Description
200	OK Content-Type: application/json	`AppsResponse`
400	Bad Request Content-Type: application/json	`ErrorResponse`	An error occurred with your request.
401	Unauthorized Content-Type: application/json	`ErrorResponse`
403	Forbidden Content-Type: application/json	`ErrorResponse`	Request not authorized.
429	Content-Type: application/json	`ErrorResponse`

List Apps

URL

Query Parameters

Response Codes

Mentioned in

Discussion

Example Request and Response

See Also

Related Documentation

Getting and modifying app information