Contents

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}/appInfos

Path Parameters

NameTypeDescription
id Requiredstring

An opaque resource ID that uniquely identifies the resource. Obtain the app resource ID from the List apps response.

Query Parameters

NameTypeDescription
fields[appInfos] Optional[string]

Additional fields to include for each app info resource returned by the response.

limit Optionalinteger

The maximum number of app info resources to return.

include Optional[string]

The relationship data to include in the response.

fields[apps] Optional[string]

Additional fields to include for each app resource returned by the response.

fields[appInfoLocalizations] Optional[string]

Additional fields to include for each app info localization resource returned by the response.

fields[appCategories] Optional[string]

Additional fields to include for each app category resource returned by the response.

fields[ageRatingDeclarations] Optional[string]

Additional fields to include for each age rating declaration resource returned by the response.

limit[appInfoLocalizations] Optionalinteger

The maximum number of related app info localizations resources to return.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
AppInfosResponse

Request succeeded.

400Bad Request
Content-Type: application/json
ErrorResponse

An error occurred with your request.

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

Request not authorized.

404Not 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