Own SiriKit? Customize your docs with AI search, analytics, and more.

Claim your docs

GET

/v1/builds/{id}

https://api.appstoreconnect.apple.com//v1/builds/{id}

Access Token Required: API Key

Query Params

fields[builds]array

the fields to include for returned resources of type builds

includearray

comma-separated list of relationships to include

fields[appEncryptionDeclarations]array

the fields to include for returned resources of type appEncryptionDeclarations

fields[betaAppReviewSubmissions]array

the fields to include for returned resources of type betaAppReviewSubmissions

fields[buildBetaDetails]array

the fields to include for returned resources of type buildBetaDetails

fields[buildIcons]array

the fields to include for returned resources of type buildIcons

fields[perfPowerMetrics]array

the fields to include for returned resources of type perfPowerMetrics

fields[preReleaseVersions]array

the fields to include for returned resources of type preReleaseVersions

fields[appStoreVersions]array

the fields to include for returned resources of type appStoreVersions

fields[diagnosticSignatures]array

the fields to include for returned resources of type diagnosticSignatures

fields[betaTesters]array

the fields to include for returned resources of type betaTesters

fields[betaBuildLocalizations]array

the fields to include for returned resources of type betaBuildLocalizations

fields[apps]array

the fields to include for returned resources of type apps

limit[betaBuildLocalizations]integer

maximum number of related betaBuildLocalizations returned (when they are included)

limit[icons]integer

maximum number of related icons returned (when they are included)

limit[individualTesters]integer

maximum number of related individualTesters returned (when they are included)

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://api.appstoreconnect.apple.com//v1/builds/{id}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET

/v1/builds/{id}

https://api.appstoreconnect.apple.com//v1/builds/{id}

Access Token Required: API Key

Query Params

fields[builds]array

the fields to include for returned resources of type builds

includearray

comma-separated list of relationships to include

fields[appEncryptionDeclarations]array

the fields to include for returned resources of type appEncryptionDeclarations

fields[betaAppReviewSubmissions]array

the fields to include for returned resources of type betaAppReviewSubmissions

fields[buildBetaDetails]array

the fields to include for returned resources of type buildBetaDetails

fields[buildIcons]array

the fields to include for returned resources of type buildIcons

fields[perfPowerMetrics]array

the fields to include for returned resources of type perfPowerMetrics

fields[preReleaseVersions]array

the fields to include for returned resources of type preReleaseVersions

fields[appStoreVersions]array

the fields to include for returned resources of type appStoreVersions

fields[diagnosticSignatures]array

the fields to include for returned resources of type diagnosticSignatures

fields[betaTesters]array

the fields to include for returned resources of type betaTesters

fields[betaBuildLocalizations]array

the fields to include for returned resources of type betaBuildLocalizations

fields[apps]array

the fields to include for returned resources of type apps

limit[betaBuildLocalizations]integer

maximum number of related betaBuildLocalizations returned (when they are included)

limit[icons]integer

maximum number of related icons returned (when they are included)

limit[individualTesters]integer

maximum number of related individualTesters returned (when they are included)

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://api.appstoreconnect.apple.com//v1/builds/{id}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}