How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

iOS AppStoreVersions API

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

iOS AppStoreVersions API is one of 199 APIs that iOS publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include AppStoreVersions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and release notes.

This API exposes 30 operations across 26 paths, and defines 80 schemas. It is described by OpenAPI 3.2.0, at version 4.3.1.

Requests are made against a single base URL, https://api.appstoreconnect.apple.com/.

30 operations 26 paths 80 schemas 1 DELETE25 GET3 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.3.1
Base URL
https://api.appstoreconnect.apple.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

iOS AppStoreVersions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (itc-bearer-token). By default, every request must be authenticated.

Paths & Operations 30

Across 26 paths, the API surfaces 30 operations — 1 DELETE, 25 GET, 3 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

AppStoreVersions 30
POST
/v1/appStoreVersions
Create App Store Versions
appStoreVersions_createInstance body → 400401403422201409429
GET
/v1/appStoreVersions/{id}
Get App Store Versions
appStoreVersions_getInstance 17 params → 400401403404200429
PATCH
/v1/appStoreVersions/{id}
Update App Store Versions
appStoreVersions_updateInstance 1 param body → 400401403404422200409429
DELETE
/v1/appStoreVersions/{id}
Delete App Store Versions
appStoreVersions_deleteInstance 1 param → 400401403404204429
GET
/v1/appStoreVersions/{id}/relationships/alternativeDistributionPackage
Get Related App Store Versions / Alternative Distribution Package
appStoreVersions_alternativeDistributionPackage_getToOneRelationship 1 param → 400401403404200429
GET
/v1/appStoreVersions/{id}/alternativeDistributionPackage
Get Related App Store Versions / Alternative Distribution Package
appStoreVersions_alternativeDistributionPackage_getToOneRelated 5 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appClipDefaultExperience
Get Related App Store Versions / App Clip Default Experience
appStoreVersions_appClipDefaultExperience_getToOneRelationship 1 param → 400401403404200429
PATCH
/v1/appStoreVersions/{id}/relationships/appClipDefaultExperience
Update Related App Store Versions / App Clip Default Experience
appStoreVersions_appClipDefaultExperience_updateToOneRelationship 1 param body → 400401403404422409204429
GET
/v1/appStoreVersions/{id}/appClipDefaultExperience
Get Related App Store Versions / App Clip Default Experience
appStoreVersions_appClipDefaultExperience_getToOneRelated 8 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appStoreReviewDetail
Get Related App Store Versions / App Store Review Detail
appStoreVersions_appStoreReviewDetail_getToOneRelationship 1 param → 400401403404200429
GET
/v1/appStoreVersions/{id}/appStoreReviewDetail
Get Related App Store Versions / App Store Review Detail
appStoreVersions_appStoreReviewDetail_getToOneRelated 6 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appStoreVersionExperimentsdeprecated
List Related App Store Versions / App Store Version Experiments
appStoreVersions_appStoreVersionExperiments_getToManyRelationship 2 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/appStoreVersionExperimentsdeprecated
List Related App Store Versions / App Store Version Experiments
appStoreVersions_appStoreVersionExperiments_getToManyRelated 8 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appStoreVersionExperimentsV2
List Related App Store Versions / App Store Version Experiments V2
appStoreVersions_appStoreVersionExperimentsV2_getToManyRelationship 2 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/appStoreVersionExperimentsV2
List Related App Store Versions / App Store Version Experiments V2
appStoreVersions_appStoreVersionExperimentsV2_getToManyRelated 10 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appStoreVersionLocalizations
List Related App Store Versions / App Store Version Localizations
appStoreVersions_appStoreVersionLocalizations_getToManyRelationship 2 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/appStoreVersionLocalizations
List Related App Store Versions / App Store Version Localizations
appStoreVersions_appStoreVersionLocalizations_getToManyRelated 12 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appStoreVersionPhasedRelease
Get Related App Store Versions / App Store Version Phased Release
appStoreVersions_appStoreVersionPhasedRelease_getToOneRelationship 1 param → 400401403404200429
GET
/v1/appStoreVersions/{id}/appStoreVersionPhasedRelease
Get Related App Store Versions / App Store Version Phased Release
appStoreVersions_appStoreVersionPhasedRelease_getToOneRelated 2 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/appStoreVersionSubmissiondeprecated
Get Related App Store Versions / App Store Version Submission
appStoreVersions_appStoreVersionSubmission_getToOneRelationship 1 param → 400401403404200429
GET
/v1/appStoreVersions/{id}/appStoreVersionSubmissiondeprecated
Get Related App Store Versions / App Store Version Submission
appStoreVersions_appStoreVersionSubmission_getToOneRelated 4 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/build
Get Related App Store Versions / Build
appStoreVersions_build_getToOneRelationship 1 param → 400401403404200429
PATCH
/v1/appStoreVersions/{id}/relationships/build
Update Related App Store Versions / Build
appStoreVersions_build_updateToOneRelationship 1 param body → 400401403404422409204429
GET
/v1/appStoreVersions/{id}/build
Get Related App Store Versions / Build
appStoreVersions_build_getToOneRelated 2 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/customerReviews
List Related App Store Versions / Customer Reviews
appStoreVersions_customerReviews_getToManyRelationship 2 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/customerReviews
List Related App Store Versions / Customer Reviews
appStoreVersions_customerReviews_getToManyRelated 11 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/gameCenterAppVersion
Get Related App Store Versions / Game Center App Version
appStoreVersions_gameCenterAppVersion_getToOneRelationship 1 param → 400401403404200429
GET
/v1/appStoreVersions/{id}/gameCenterAppVersion
Get Related App Store Versions / Game Center App Version
appStoreVersions_gameCenterAppVersion_getToOneRelated 5 params → 400401403404200429
GET
/v1/appStoreVersions/{id}/relationships/routingAppCoverage
Get Related App Store Versions / Routing App Coverage
appStoreVersions_routingAppCoverage_getToOneRelationship 1 param → 400401403404200429
GET
/v1/appStoreVersions/{id}/routingAppCoverage
Get Related App Store Versions / Routing App Coverage
appStoreVersions_routingAppCoverage_getToOneRelated 4 params → 400401403404200429

Schemas 80

The contract defines 80 schemas that model the data the API accepts and returns. The most detailed are AppScreenshotSet (5 properties), CustomerReviewResponseV1 (5 properties), AppStoreVersionExperimentTreatment (5 properties), AppStoreReviewAttachment (5 properties). Each schema is shown below with its type and property counts.

AppStoreVersionSubmission
object
4 properties 2 required
ChecksumAlgorithm
string
SubscriptionStatusUrlVersion
string
AppStoreVersionExperimentTreatment
object
5 properties 2 required
AppStoreReviewAttachment
object
5 properties 2 required
AppVersionState
string
AppMediaAssetState
object
3 properties
ResourceLinks
object
1 property
AppStoreVersionPhasedRelease
object
4 properties 2 required
AppStoreReviewDetailResponse
object
3 properties 2 required
HttpHeader
object
2 properties
AppPreviewSet
object
5 properties 2 required
AppStoreVersionSubmissionResponse
object
3 properties 2 required
CustomerReviewsResponse
object
4 properties 2 required
AppStoreVersionResponse
object
3 properties 2 required
ErrorLinks
object
2 properties
ErrorSourcePointer
object
1 property 1 required
AppStoreVersionLocalizationsResponse
object
4 properties 2 required
AppClipAppStoreReviewDetail
object
5 properties 2 required
GameCenterAppVersionResponse
object
3 properties 2 required
AppStoreReviewDetail
object
5 properties 2 required
AppStoreVersionExperimentsResponse
object
4 properties 2 required
AppClip
object
5 properties 2 required
AppClipDefaultExperience
object
5 properties 2 required
AppStoreVersionRoutingAppCoverageLinkageResponse
object
2 properties 2 required
AppStoreVersionAppStoreReviewDetailLinkageResponse
object
2 properties 2 required
AppStoreVersionBuildLinkageResponse
object
2 properties 2 required
ImageAsset
object
3 properties
AlternativeDistributionPackageVersion
object
5 properties 2 required
AppStoreVersionExperiment
object
5 properties 2 required
AppStoreVersionCreateRequest
object
1 property 1 required
AlternativeDistributionPackage
object
5 properties 2 required
AppStoreVersionExperimentV2
object
5 properties 2 required
PhasedReleaseState
string
AppStoreVersionPhasedReleaseWithoutIncludesResponse
object
2 properties 2 required
AppStoreVersionAlternativeDistributionPackageLinkageResponse
object
2 properties 2 required
AppStoreVersionAppStoreVersionLocalizationsLinkagesResponse
object
3 properties 2 required
AppStoreVersionAppClipDefaultExperienceLinkageResponse
object
2 properties 2 required
ErrorSourceParameter
object
1 property 1 required
UploadOperation
object
5 properties
AppClipDefaultExperienceLocalization
object
5 properties 2 required
BuildWithoutIncludesResponse
object
2 properties 2 required
AlternativeDistributionPackageResponse
object
3 properties 2 required
BuildAudienceType
string
AppClipDefaultExperienceResponse
object
3 properties 2 required
AppStoreVersionCustomerReviewsLinkagesResponse
object
3 properties 2 required
RelationshipLinks
object
2 properties
AppStoreVersionGameCenterAppVersionLinkageResponse
object
2 properties 2 required
Checksums
object
2 properties
RoutingAppCoverage
object
5 properties 2 required
App
object
5 properties 2 required
AppScreenshotSet
object
5 properties 2 required
RoutingAppCoverageResponse
object
3 properties 2 required
TerritoryCode
string
ScreenshotDisplayType
string
AppMediaStateError
object
2 properties
CustomerReviewResponseV1
object
5 properties 2 required
GameCenterAppVersion
object
5 properties 2 required
AppClipAction
string
Territory
object
4 properties 2 required
ErrorResponse
object
1 property
AppStoreVersionAppStoreVersionExperimentsV2LinkagesResponse
object
3 properties 2 required
CustomerReview
object
5 properties 2 required
AppStoreVersion
object
5 properties 2 required
AppStoreVersionAppStoreVersionPhasedReleaseLinkageResponse
object
2 properties 2 required
AppStoreVersionExperimentsV2Response
object
4 properties 2 required
AppStoreVersionAppClipDefaultExperienceLinkageRequest
object
1 property 1 required
AppStoreVersionAppStoreVersionSubmissionLinkageResponse
object
2 properties 2 required
AppStoreVersionUpdateRequest
object
1 property 1 required
DocumentLinks
object
1 property 1 required
PreviewType
string
AppStoreVersionState
string
Platform
string
AppStoreVersionAppStoreVersionExperimentsLinkagesResponse
object
3 properties 2 required
PagedDocumentLinks
object
3 properties 1 required
AppKeyword
object
3 properties 2 required
PagingInformation
object
1 property 1 required
AppStoreVersionBuildLinkageRequest
object
1 property 1 required
Build
object
5 properties 2 required
AppStoreVersionLocalization
object
5 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ios-appstoreversions-api-openapi.yml Raw ↑

Other APIs iOS publishes across the network.

App Store Server API
App Store Server Notifications
Apple Push Notification Service (APNs)
DeviceCheck and App Attest
Sign in with Apple REST API
Apple Music API
Wallet / PassKit Web Service
iOS AccessibilityDeclarations API
iOS Actors API
iOS AgeRatingDeclarations API
iOS AlternativeDistributionDomains API
iOS AlternativeDistributionKeys API
Where this information came from

This is an independent, third-party profile of iOS AppStoreVersions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.