<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/build-bundles",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Build Bundles"
}
-->

# Build Bundles

Read metadata for app and App Clip binaries included in a build you upload to App Store Connect.

## Discussion

A `buildBundles` resource represents metadata for binaries you upload to App Store Connect as a build. It provides detailed information like capabilities an app uses, supported CPU architectures, and more. For a full list of available attributes, see [`BuildBundle.Attributes`](/documentation/AppStoreConnectAPI/BuildBundle/Attributes-data.dictionary).

When you upload a build that contains an App Clip, use the APIs provided by the `buildBundles` resource to read:

- Cache status information for domains you associated with your App Clip
- Debug status information for domains you associated with your App Clip
- App Clip invocations you configured for testers who use the TestFlight app to launch your App Clip
- File size information for a build bundle

## Topics

### Getting Build Bundle Information

[`GET /v1/buildBundles/{id}/appClipDomainCacheStatus`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-appClipDomainCacheStatus)

Get the cache status of the domain you associate with your App Clip for a specific build bundle.

[`GET /v1/buildBundles/{id}/appClipDomainDebugStatus`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-appClipDomainDebugStatus)

Get the debug status of the domain you associate with your App Clip for a specific build bundle.

[`GET /v1/buildBundles/{id}/betaAppClipInvocations`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-betaAppClipInvocations)

Get all App Clip invocations you configure for testing for a specific build bundle.

[`GET /v1/buildBundles/{id}/buildBundleFileSizes`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-buildBundleFileSizes)

Get all file sizes for a specific build bundle.

[`GET /v1/buildBundles/{id}/relationships/appClipDomainCacheStatus`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-relationships-appClipDomainCacheStatus)

[`GET /v1/buildBundles/{id}/relationships/appClipDomainDebugStatus`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-relationships-appClipDomainDebugStatus)

[`GET /v1/buildBundles/{id}/relationships/betaAppClipInvocations`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-relationships-betaAppClipInvocations)

[`GET /v1/buildBundles/{id}/relationships/buildBundleFileSizes`](/documentation/AppStoreConnectAPI/GET-v1-buildBundles-_id_-relationships-buildBundleFileSizes)

### Objects

[`BuildBundle`](/documentation/AppStoreConnectAPI/BuildBundle)

A specific binary bundle within a build, such as an app extension, App Clip, or nested app target.

[`BuildBundleType`](/documentation/AppStoreConnectAPI/BuildBundleType)

A string that represents the possible components of a build bundle.

[`AppClipDomainStatus`](/documentation/AppStoreConnectAPI/AppClipDomainStatus)

The validation status of the associated domains configured for an App Clip, indicating whether each domain is reachable and correctly set up.

[`BuildBundleFileSize`](/documentation/AppStoreConnectAPI/BuildBundleFileSize)

The estimated and actual download and install sizes for a build bundle, broken down by device type.

[`AppClipDomainStatusResponse`](/documentation/AppStoreConnectAPI/AppClipDomainStatusResponse)

A response containing the validation status of associated domains configured for an App Clip.

[`BetaAppClipInvocationsResponse`](/documentation/AppStoreConnectAPI/BetaAppClipInvocationsResponse)

A response containing a list of TestFlight App Clip invocations for a beta build.

[`BuildBundleFileSizesResponse`](/documentation/AppStoreConnectAPI/BuildBundleFileSizesResponse)

A response containing a list of download and install size estimates for a build’s bundles.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)