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

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

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

## Query parameters

- `fields[preReleaseVersions]` string[]

## Response `200`

Related resource

- PrereleaseVersionResponse
  - `data` PrereleaseVersion, required
    - `attributes` object
      - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
      - `version` string
    - `id` string, required
    - `links` ResourceLinks, required
      - `self` string, uri-reference, required
    - `relationships` object
      - `app` object
        - `data` object
          - `id` string, required
          - `type` 'apps', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `builds` object
        - `data` object[]
          - `id` string, required
          - `type` 'builds', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
    - `type` 'preReleaseVersions', required
  - `included` union[]
    - union
      - 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
      - App
        - `attributes` object
          - `availableInNewTerritories` boolean
          - `bundleId` string
          - `contentRightsDeclaration` 'DOES_NOT_USE_THIRD_PARTY_CONTENT' | 'USES_THIRD_PARTY_CONTENT'
          - `isOrEverWasMadeForKids` boolean
          - `name` string
          - `primaryLocale` string
          - `sku` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `appInfos` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appStoreVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `availableTerritories` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaAppLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaAppReviewDetail` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaGroups` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `betaLicenseAgreement` object
            - `data` object
              - …
            - `links` object
              - …
          - `builds` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `endUserLicenseAgreement` object
            - `data` object
              - …
            - `links` object
              - …
          - `gameCenterEnabledVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `inAppPurchases` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `preOrder` object
            - `data` object
              - …
            - `links` object
              - …
          - `preReleaseVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `prices` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'apps', 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)