App Store Versions
Read the build information of an App Store version
Read build information as a flat JSON object.
GET
/apps/{appId}/versions/{versionId}/buildProposed · Read parity · Adapter not implemented
Request
Routes are relative to your connection. Use a facade API key; the service manages Apple authentication.
BASE='https://asc.example.com/v1/connections/conn_example'
curl --fail-with-body "$BASE/apps/1234567890/versions/version_123/build" \
-H "Authorization: Bearer $ASC_FACADE_KEY"const base = "https://asc.example.com/v1/connections/conn_example";
const response = await fetch(`${base}/apps/1234567890/versions/version_123/build`, {
headers: { Authorization: `Bearer ${process.env.ASC_FACADE_KEY}` }
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.message ?? `HTTP ${response.status}`);
}
console.log(body);import json
import os
from urllib.request import Request, urlopen
from urllib.error import HTTPError
base = "https://asc.example.com/v1/connections/conn_example"
request = Request(
f"{base}/apps/1234567890/versions/version_123/build",
headers={"Authorization": f"Bearer {os.environ['ASC_FACADE_KEY']}"},
)
try:
with urlopen(request) as response:
print(json.load(response))
except HTTPError as error:
detail = json.load(error)
raise RuntimeError(detail["error"]["message"]) from errorasc.example.com is a placeholder for your deployment. Examples use fictional IDs.
Path parameters
| Name | Type | Description |
|---|---|---|
| appId | string | Apple’s app ID. Returned by List apps. |
| versionId | string | An explicit version ID belonging to this app. Select it from the version list. |
Query parameters
| Name | Type | Description |
|---|---|---|
| fields | string | Comma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.Valuesversion, uploadedDate, expirationDate, expired, minOsVersion, lsMinimumSystemVersion, computedMinMacOsVersion, computedMinVisionOsVersion, iconAssetToken, processingState, buildAudienceType, usesNonExemptEncryption |
Response
One flat object for the selected resource.
{
"id": "build_123",
"appId": "1234567890",
"versionId": "version_123",
"version": "42",
"uploadedDate": "2026-10-13T18:00:00Z",
"expirationDate": "2027-01-11T18:00:00Z"
}Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Apple’s resource ID. Keep this string unchanged when addressing a resource. |
| appId | string | The app that owns this resource. |
| versionId | string | The selected App Store version. |
| version | string | The uploaded build’s version string; this is separate from the store versionString. |
| uploadedDate | string · date-time | When Apple received the build, as an RFC 3339 timestamp. |
| expirationDate | string · date-time | When this build expires for testing, as an RFC 3339 timestamp. |
| expired | boolean | Whether the build has expired. |
| minOsVersion | string | The minimum supported OS version reported by the build. |
| lsMinimumSystemVersion | string | The minimum macOS system version recorded in the build. |
| computedMinMacOsVersion | string | The macOS minimum version calculated by Apple for this build. |
| computedMinVisionOsVersion | string | The visionOS minimum version calculated by Apple for this build. |
| iconAssetToken | object | Apple’s icon asset token, preserved as returned. |
| processingState | string | Apple’s build-processing state. This does not indicate App Review approval.ValuesPROCESSING, FAILED, INVALID, VALID |
| buildAudienceType | string | Whether a build is internal-only or eligible for App Store distribution.ValuesINTERNAL_ONLY, APP_STORE_ELIGIBLE |
| usesNonExemptEncryption | boolean | Whether the build uses encryption that is not exempt from export compliance. |
| preReleaseVersionId | string | null | ID of the related pre release version. Present only when Apple supplies linkage; related objects are not loaded automatically. |
| appEncryptionDeclarationId | string | null | ID of the related app encryption declaration. Present only when Apple supplies linkage; related objects are not loaded automatically. |
| betaAppReviewSubmissionId | string | null | ID of the related beta app review submission. Present only when Apple supplies linkage; related objects are not loaded automatically. |
| buildBetaDetailId | string | null | ID of the related build beta detail. Present only when Apple supplies linkage; related objects are not loaded automatically. |
| buildUploadId | string | null | ID of the related build upload. Present only when Apple supplies linkage; related objects are not loaded automatically. |
iconAssetToken fields
| Name | Type | Description |
|---|---|---|
| templateUrl | string | The template url value reported by Apple for this resource. |
| width | integer | The width value reported by Apple for this resource. |
| height | integer | The height value reported by Apple for this resource. |
Behavior
- A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data.
Errors
| HTTP | Type | Description |
|---|---|---|
| 400 | invalid_query | Unsupported filter, sort, limit, or cursor. |
| 401 | unauthorized | Missing or invalid facade API key. |
| 403 | forbidden / upstream_forbidden | The caller or configured Apple key cannot read this resource. |
| 404 | resource_not_found | The requested resource, parent, or exact locale is absent or outside the caller’s scope. |
| 429 | rate_limited | A facade or Apple rate limit was reached. Respect Retry-After when returned. |
| 502–504 | upstream error | Apple authentication, response parsing, availability, or timeout failure; this is not an empty result. |
Apple mapping
Upstream route and translation
The adapter calls GET /v1/appStoreVersions/{id}/build. Read Apple’s original endpoint ↗
Flatten Apple’s attributes into each resource object. Expose supplied singleton linkage as IDs, with no automatic relationship traversal. Read access does not make these fields writable.
| Facade parameter | Type | Description |
|---|---|---|
| fields | query | fields[builds] |
Reviewed 2026-10-14 · OpenAPI 4.5.1