---
title: "GET /v1/builds/{id}/appStoreVersion"
method: GET
path: "/v1/builds/{id}/appStoreVersion"
tags: ["Builds"]
---

# GET /v1/builds/{id}/appStoreVersion

`GET /v1/builds/{id}/appStoreVersion`

## Query parameters

- `fields[appStoreVersions]` string[]

## Response `200`

Related resource

- AppStoreVersionResponse
  - `data` AppStoreVersion, required
    - `attributes` object
      - `appStoreState` 'DEVELOPER_REMOVED_FROM_SALE' | 'DEVELOPER_REJECTED' | 'IN_REVIEW' | 'INVALID_BINARY' | 'METADATA_REJECTED' | 'PENDING_APPLE_RELEASE' | 'PENDING_CONTRACT' | 'PENDING_DEVELOPER_RELEASE' | 'PREPARE_FOR_SUBMISSION' | 'PREORDER_READY_FOR_SALE' | 'PROCESSING_FOR_APP_STORE' | 'READY_FOR_SALE' | 'REJECTED' | 'REMOVED_FROM_SALE' | 'WAITING_FOR_EXPORT_COMPLIANCE' | 'WAITING_FOR_REVIEW' | 'REPLACED_WITH_NEW_VERSION'
      - `copyright` string
      - `createdDate` string, date-time
      - `downloadable` boolean
      - `earliestReleaseDate` string, date-time
      - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
      - `releaseType` 'MANUAL' | 'AFTER_APPROVAL' | 'SCHEDULED'
      - `usesIdfa` boolean
      - `versionString` string
    - `id` string, required
    - `links` ResourceLinks, required
      - `self` string, uri-reference, required
    - `relationships` object
      - `ageRatingDeclaration` object
        - `data` object
          - `id` string, required
          - `type` 'ageRatingDeclarations', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `app` object
        - `data` object
          - `id` string, required
          - `type` 'apps', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `appStoreReviewDetail` object
        - `data` object
          - `id` string, required
          - `type` 'appStoreReviewDetails', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `appStoreVersionLocalizations` object
        - `data` object[]
          - `id` string, required
          - `type` 'appStoreVersionLocalizations', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `appStoreVersionPhasedRelease` object
        - `data` object
          - `id` string, required
          - `type` 'appStoreVersionPhasedReleases', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `appStoreVersionSubmission` object
        - `data` object
          - `id` string, required
          - `type` 'appStoreVersionSubmissions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `build` object
        - `data` object
          - `id` string, required
          - `type` 'builds', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `idfaDeclaration` object
        - `data` object
          - `id` string, required
          - `type` 'idfaDeclarations', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `routingAppCoverage` object
        - `data` object
          - `id` string, required
          - `type` 'routingAppCoverages', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
    - `type` 'appStoreVersions', required
  - `included` union[]
    - union
      - AgeRatingDeclaration
        - `attributes` object
          - `alcoholTobaccoOrDrugUseOrReferences` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `contests` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `gambling` boolean
          - `gamblingAndContests` boolean
          - `gamblingSimulated` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `horrorOrFearThemes` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `kidsAgeBand` 'FIVE_AND_UNDER' | 'SIX_TO_EIGHT' | 'NINE_TO_ELEVEN'
          - `matureOrSuggestiveThemes` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `medicalOrTreatmentInformation` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `profanityOrCrudeHumor` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `seventeenPlus` boolean
          - `sexualContentGraphicAndNudity` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `sexualContentOrNudity` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `unrestrictedWebAccess` boolean
          - `violenceCartoonOrFantasy` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `violenceRealistic` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
          - `violenceRealisticProlongedGraphicOrSadistic` 'NONE' | 'INFREQUENT_OR_MILD' | 'FREQUENT_OR_INTENSE'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'ageRatingDeclarations', required
      - AppStoreVersionLocalization
        - `attributes` object
          - `description` string
          - `keywords` string
          - `locale` string
          - `marketingUrl` string, uri
          - `promotionalText` string
          - `supportUrl` string, uri
          - `whatsNew` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appPreviewSets` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appScreenshotSets` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appStoreVersionLocalizations', required
      - Build
        - `attributes` object
          - `expirationDate` string, date-time
          - `expired` boolean
          - `iconAssetToken` ImageAsset
            - `height` integer
            - `templateUrl` string
            - `width` integer
          - `minOsVersion` string
          - `processingState` 'PROCESSING' | 'FAILED' | 'INVALID' | 'VALID'
          - `uploadedDate` string, date-time
          - `usesNonExemptEncryption` boolean
          - `version` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `appEncryptionDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaAppReviewSubmission` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaBuildLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `buildBetaDetail` object
            - `data` object
              - …
            - `links` object
              - …
          - `icons` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `individualTesters` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `preReleaseVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'builds', required
      - AppStoreVersionPhasedRelease
        - `attributes` object
          - `currentDayNumber` integer
          - `phasedReleaseState` 'INACTIVE' | 'ACTIVE' | 'PAUSED' | 'COMPLETE'
          - `startDate` string, date-time
          - `totalPauseDuration` integer
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'appStoreVersionPhasedReleases', required
      - RoutingAppCoverage
        - `attributes` object
          - `assetDeliveryState` AppMediaAssetState
            - `errors` AppMediaStateError[]
              - …
            - `state` 'AWAITING_UPLOAD' | 'UPLOAD_COMPLETE' | 'COMPLETE' | 'FAILED'
            - `warnings` AppMediaStateError[]
              - …
          - `fileName` string
          - `fileSize` integer
          - `sourceFileChecksum` string
          - `uploadOperations` UploadOperation[]
            - `length` integer
            - `method` string
            - `offset` integer
            - `requestHeaders` UploadOperationHeader[]
              - …
            - `url` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'routingAppCoverages', required
      - AppStoreReviewDetail
        - `attributes` object
          - `contactEmail` string
          - `contactFirstName` string
          - `contactLastName` string
          - `contactPhone` string
          - `demoAccountName` string
          - `demoAccountPassword` string
          - `demoAccountRequired` boolean
          - `notes` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appStoreReviewAttachments` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appStoreReviewDetails', required
      - AppStoreVersionSubmission
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appStoreVersionSubmissions', required
      - IdfaDeclaration
        - `attributes` object
          - `attributesActionWithPreviousAd` boolean
          - `attributesAppInstallationToPreviousAd` boolean
          - `honorsLimitedAdTracking` boolean
          - `servesAds` boolean
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'idfaDeclarations', required
  - `links` DocumentLinks, required
    - `self` string, uri-reference, required

## Other responses

- `400` — Parameter error(s)
- `403` — Forbidden error
- `404` — Not found error

---

[API](https://skmtc.net/apple/apis/app-store-connect.md) · [All operations](https://skmtc.net/apple/apis/app-store-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apple/app-store-connect/versions/e085db5c8896/schema)