List All App Infos for an App
Get information about an app that is currently live on App Store, or that goes live with the next version.
URL
GET https://api.appstoreconnect.apple.com/v1/apps/{id}/appInfosPath Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | An opaque resource ID that uniquely identifies the resource. Obtain the app resource ID from the List Apps response. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[appInfos] Optional | [string] | Fields to return for included related types. |
limit Optional | integer | Number of resources to return. |
include Optional | [string] | Relationship data to include in the response. |
fields[apps] Optional | [string] | Fields to return for included related types. |
fields[appInfoLocalizations] Optional | [string] | Fields to return for included related types. |
fields[appCategories] Optional | [string] | Fields to return for included related types. |
fields[ageRatingDeclarations] Optional | [string] | Fields to return for included related types. |
limit[appInfoLocalizations] Optional | integer |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AppInfosResponse | Request succeeded. |
| 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. |
| 404 | Not Found Content-Type: application/json | ErrorResponse | Resource not found. |
| 429 | Content-Type: application/json | ErrorResponse |
Discussion
Use this endpoint to retrieve the derived app-level information for an app. If the app has both a “Ready for Sale” version and a version you’re preparing for release, it will have two app infos. One represents information about the app currently in the App Store, and the other represents the information that takes effect when you release the next version. Use the appStoreState attribute to differentiate them.
Example Request and Response
See Also
Getting App Store details for your app
GET /v1/apps/{id}/relationships/appInfosList All App Store Versions for an AppGET /v1/apps/{id}/relationships/appStoreVersionsRead the End User License Agreement Information of an AppGET /v1/apps/{id}/relationships/endUserLicenseAgreementList all custom product pages for an appGet all custom product page resource IDs for an appGET /v1/apps/{id}/appStoreVersionExperimentsV2GET /v1/apps/{id}/relationships/appStoreVersionExperimentsV2