iOS

iOS AppStoreVersions API

The AppStoreVersions API from iOS — 26 operation(s) for appstoreversions.

GitHub OpenAPI

Operations 30

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/appStoreVersions Create a new App Store version for an app · Create App Store Versions #
Ask an LLM
“How do I start a new App Store version so I can prepare my next release in App Store Connect?”
“Can I create a version record with a version string and platform before uploading a build?”
Tell an agent
Create a new App Store version with these attributes: {data}.
Open a new App Store version for my next iOS release using {data}.
GET /v1/appStoreVersions/{id} Get an App Store version · Get App Store Versions #
Ask an LLM
“What state is a specific App Store version in right now?”
“Can I look up the version string, platform and release type of one App Store version?”
Tell an agent
Show me App Store version {id}.
Fetch the details and current state of App Store version {id}.
PATCH /v1/appStoreVersions/{id} Update an App Store version · Update App Store Versions #
Ask an LLM
“Can I change the version string or release type of an App Store version that already exists?”
“Which settings on an existing App Store version, such as copyright or scheduled release date, can I edit?”
Tell an agent
Update App Store version {id} with {data}.
Change the copyright and release settings on existing version {id} to {data}.
DELETE /v1/appStoreVersions/{id} Delete an App Store version · Delete App Store Versions #
Ask an LLM
“Can I throw away an App Store version I created by mistake?”
“Is it possible to remove an unreleased app version entirely?”
Tell an agent destructive · confirm first
Delete App Store version {id}.
Remove the draft App Store version {id} I no longer need.
GET /v1/appStoreVersions/{id}/relationships/alternativeDistributionPackage Get the alternative distribution package ID for a version · Get Related App Store Versions / Alternative Distribution Package #
Ask an LLM
“Which alternative distribution package ID is linked to an App Store version, without the full package details?”
“Is there an alternative distribution package reference attached to this version at all?”
Tell an agent
Give me only the linked alternative distribution package ID for version {id}.
Check whether App Store version {id} has an alternative distribution package linkage.
GET /v1/appStoreVersions/{id}/alternativeDistributionPackage Get the alternative distribution package for a version · Get Related App Store Versions / Alternative Distribution Package #
Ask an LLM
“Where can I see the full alternative distribution package record for an App Store version?”
“What does the alternative marketplace distribution package for my release contain?”
Tell an agent
Show the full alternative distribution package for App Store version {id}.
Fetch the alternative distribution package details tied to version {id}.
GET /v1/appStoreVersions/{id}/relationships/appClipDefaultExperience Get the App Clip default experience ID for a version · Get Related App Store Versions / App Clip Default Experience #
Ask an LLM
“Which App Clip default experience ID is currently linked to an App Store version?”
“Can I get just the reference to a version's default App Clip experience, not the full record?”
Tell an agent
Return only the App Clip default experience ID linked to version {id}.
Check which default App Clip experience linkage version {id} points at.
PATCH /v1/appStoreVersions/{id}/relationships/appClipDefaultExperience Link a default App Clip experience to a version · Update Related App Store Versions / App Clip Default Experience #
Ask an LLM
“Can I point an App Store version at a different default App Clip experience?”
“What is the way to attach an existing App Clip default experience to my release?”
Tell an agent
Set the default App Clip experience of version {id} to {data}.
Relink App Store version {id} to App Clip default experience {data}.
GET /v1/appStoreVersions/{id}/appClipDefaultExperience Get the App Clip default experience for a version · Get Related App Store Versions / App Clip Default Experience #
Ask an LLM
“What does the default App Clip experience for an App Store version look like in full?”
“Can I read the action and subtitle of the App Clip card shipped with a release?”
Tell an agent
Show the full default App Clip experience for App Store version {id}.
Fetch the App Clip default experience details attached to version {id}.
GET /v1/appStoreVersions/{id}/relationships/appStoreReviewDetail Get the App Review detail ID for a version · Get Related App Store Versions / App Store Review Detail #
Ask an LLM
“Which App Store review detail ID belongs to an App Store version?”
“Can I get only the linkage to a version's review detail without the contact info?”
Tell an agent
Return just the App Store review detail ID linked to version {id}.
Look up the review detail reference for App Store version {id}.
GET /v1/appStoreVersions/{id}/appStoreReviewDetail Get the App Review contact and demo details for a version · Get Related App Store Versions / App Store Review Detail #
Ask an LLM
“What reviewer contact info, demo account and notes did I give App Review for this version?”
“Can I check the review notes submitted alongside a specific app version?”
Tell an agent
Show the App Review contact, demo login and notes for version {id}.
Fetch the full App Store review detail for App Store version {id}.
GET /v1/appStoreVersions/{id}/relationships/appStoreVersionExperiments List product page experiment IDs for a version · List Related App Store Versions / App Store Version Experiments #
Ask an LLM
“Which product page optimization experiment IDs are linked to an App Store version under the original experiments model?”
“Can I get just the IDs of the v1 experiments on a version without their details?”
Tell an agent
List only the IDs of the original (v1) product page experiments on version {id}.
Give me up to {limit} v1 experiment linkages for App Store version {id}.
GET /v1/appStoreVersions/{id}/appStoreVersionExperiments List product page experiments for a version · List Related App Store Versions / App Store Version Experiments #
Ask an LLM
“What product page optimization tests are running on this app version under the original experiments API?”
“Can I filter a version's v1 experiments by state, like only the ones in review or completed?”
Tell an agent
Show the full original (v1) product page experiments for version {id}.
List v1 experiments on version {id} that are in state {state}.
GET /v1/appStoreVersions/{id}/relationships/appStoreVersionExperimentsV2 List V2 product page experiment IDs for a version · List Related App Store Versions / App Store Version Experiments V2 #
Ask an LLM
“Which V2 product page experiment IDs are attached to an App Store version?”
“Can I fetch only the linkages for the newer V2 experiments on a version?”
Tell an agent
List only the IDs of the V2 product page experiments on version {id}.
Return up to {limit} V2 experiment linkages for App Store version {id}.
GET /v1/appStoreVersions/{id}/appStoreVersionExperimentsV2 List V2 product page experiments for a version · List Related App Store Versions / App Store Version Experiments V2 #
Ask an LLM
“What V2 product page optimization experiments exist for this app version, with their full details?”
“Is there a way to see only the V2 experiments on a version that are currently running?”
Tell an agent
Show the full V2 product page experiments for App Store version {id}.
List the V2 experiments on version {id} whose state is {state}.
GET /v1/appStoreVersions/{id}/relationships/appStoreVersionLocalizations List localization IDs for an App Store version · List Related App Store Versions / App Store Version Localizations #
Ask an LLM
“Which localization IDs are attached to an App Store version?”
“Can I get just the localization references for a version without the description text?”
Tell an agent
List only the localization IDs for App Store version {id}.
Return up to {limit} localization linkages for version {id}.
GET /v1/appStoreVersions/{id}/appStoreVersionLocalizations List localized metadata for an App Store version · List Related App Store Versions / App Store Version Localizations #
Ask an LLM
“What descriptions, keywords and what's-new text does my version have in each language?”
“Can I pull the localized store metadata of a version for just one locale, like de-DE?”
Tell an agent
Show every localization with its store text for App Store version {id}.
Get the {locale} localization of App Store version {id}.
GET /v1/appStoreVersions/{id}/relationships/appStoreVersionPhasedRelease Get the phased release ID for a version · Get Related App Store Versions / App Store Version Phased Release #
Ask an LLM
“Which phased release ID is linked to an App Store version?”
“Can I check whether a version has a phased release reference without loading its state?”
Tell an agent
Return only the phased release ID linked to version {id}.
Check the phased release linkage on App Store version {id}.
GET /v1/appStoreVersions/{id}/appStoreVersionPhasedRelease Get the phased release status for a version · Get Related App Store Versions / App Store Version Phased Release #
Ask an LLM
“How far along is the seven-day phased rollout of my current app version?”
“Is the phased release for this version active, paused or complete?”
Tell an agent
Show the phased release state and current day for App Store version {id}.
Fetch the full phased release record of version {id}.
GET /v1/appStoreVersions/{id}/relationships/appStoreVersionSubmission Get the review submission ID for a version · Get Related App Store Versions / App Store Version Submission #
Ask an LLM
“Which App Store version submission ID is linked to this version?”
“Can I get only the submission reference for a version, not the submission itself?”
Tell an agent
Return just the version submission ID linked to App Store version {id}.
Check the submission linkage on version {id}.
GET /v1/appStoreVersions/{id}/appStoreVersionSubmission Get the review submission for a version · Get Related App Store Versions / App Store Version Submission #
Ask an LLM
“Has this App Store version been submitted for review, and what does that submission record show?”
“Where do I see the full submission object behind a version sent to App Review?”
Tell an agent
Show the full App Store version submission for version {id}.
Fetch the review submission details attached to version {id}.
GET /v1/appStoreVersions/{id}/relationships/build Get the build ID attached to a version · Get Related App Store Versions / Build #
Ask an LLM
“Which build ID is currently selected for an App Store version?”
“Can I get only the build reference for a version without the build metadata?”
Tell an agent
Return only the ID of the build attached to App Store version {id}.
Check which build linkage version {id} is pointing at.
PATCH /v1/appStoreVersions/{id}/relationships/build Attach a build to an App Store version · Update Related App Store Versions / Build #
Ask an LLM
“How do I choose which uploaded build ships with an App Store version?”
“Can I swap the build on a version before submitting it for review?”
Tell an agent
Attach build {data} to App Store version {id}.
Replace the selected build on version {id} with {data}.
GET /v1/appStoreVersions/{id}/build Get the build attached to a version · Get Related App Store Versions / Build #
Ask an LLM
“What build number and upload details belong to the build selected for this version?”
“Can I see whether the build on my release has finished processing?”
Tell an agent
Show the full build record attached to App Store version {id}.
Fetch the build details, including processing state, for version {id}.
GET /v1/appStoreVersions/{id}/relationships/customerReviews List customer review IDs for a version · List Related App Store Versions / Customer Reviews #
Ask an LLM
“Which customer review IDs were left on a specific App Store version?”
“Can I page through just the review references for a version without the review text?”
Tell an agent
List only the customer review IDs for App Store version {id}.
Return up to {limit} review linkages for version {id}.
GET /v1/appStoreVersions/{id}/customerReviews List customer reviews for an App Store version · List Related App Store Versions / Customer Reviews #
Ask an LLM
“What are customers saying in reviews of this specific app version?”
“Can I filter a version's reviews to only one-star ratings from a single territory?”
Tell an agent
Show the customer reviews written for App Store version {id}.
List {rating}-star reviews of version {id} from territory {territory}.
GET /v1/appStoreVersions/{id}/relationships/gameCenterAppVersion Get the Game Center app version ID for a version · Get Related App Store Versions / Game Center App Version #
Ask an LLM
“Which Game Center app version ID is linked to an App Store version?”
“Can I get just the Game Center app version reference for a release?”
Tell an agent
Return only the Game Center app version ID linked to version {id}.
Check the Game Center app version linkage on App Store version {id}.
GET /v1/appStoreVersions/{id}/gameCenterAppVersion Get the Game Center app version for a version · Get Related App Store Versions / Game Center App Version #
Ask an LLM
“Is Game Center enabled for this App Store version, and what does its Game Center app version show?”
“Where can I read the full Game Center configuration tied to a release?”
Tell an agent
Show the full Game Center app version for App Store version {id}.
Fetch the Game Center app version record attached to version {id}.
GET /v1/appStoreVersions/{id}/relationships/routingAppCoverage Get the routing app coverage ID for a version · Get Related App Store Versions / Routing App Coverage #
Ask an LLM
“Which routing app coverage file ID is linked to an App Store version?”
“Can I check only the routing coverage reference on a navigation app's version?”
Tell an agent
Return only the routing app coverage ID linked to version {id}.
Check the routing app coverage linkage on App Store version {id}.
GET /v1/appStoreVersions/{id}/routingAppCoverage Get the routing app coverage file for a version · Get Related App Store Versions / Routing App Coverage #
Ask an LLM
“What geographic routing coverage file did I upload for my navigation app version?”
“Has the routing app coverage file for this version finished processing?”
Tell an agent
Show the full routing app coverage file for App Store version {id}.
Fetch the routing coverage upload details and status for version {id}.

Documentation

📖
Documentation
https://developer.apple.com/documentation/appstoreconnectapi
📖
APIReference
https://developer.apple.com/documentation/appstoreconnectapi
📖
GettingStarted
https://developer.apple.com/documentation/appstoreconnectapi/creating-api-keys-for-app-store-connect-api
📖
Authentication
https://developer.apple.com/documentation/appstoreconnectapi/generating-tokens-for-api-requests

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-appstoreversions-api-openapi.yml

Other Resources

🔗
ReleaseNotes
https://developer.apple.com/documentation/appstoreconnectapi/app-store-connect-api-release-notes
🔗
SDKs
https://github.com/apple/app-store-server-library-swift
🔗
SDKs
https://github.com/apple/app-store-server-library-java
🔗
SDKs
https://github.com/apple/app-store-server-library-python
🔗
SDKs
https://github.com/apple/app-store-server-library-node

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ios:ios-appstoreversions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ios-appstoreversions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: App Store Connect App Store Versions API
  version: 4.3.1
  x-platforms:
    app_store_connect_api: App Store Connect API
  description: The App Store Connect API is the standards-based REST API Apple provides to automate tasks across App Store Connect, Xcode, and Certificates, Identifiers & Profiles.
servers:
- url: https://api.appstoreconnect.apple.com/
security:
- itc-bearer-token: []
tags:


# --- truncated at 32 KB (201 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-appstoreversions-api-openapi.yml