iOS

iOS Builds API

The Builds API from iOS — 25 operation(s) for builds.

GitHub OpenAPI
Business capability
Software Release & Deployment Management BC-4210

Operations 30

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/builds List builds uploaded to App Store Connect · List Builds #
Ask an LLM
“How do I list all the builds I've uploaded to App Store Connect?”
“Can I filter my builds to only the ones that are still processing or have expired?”
Tell an agent
List every build for app {app}.
Show builds with version {version} that are in processing state {state}.
GET /v1/builds/{id} Get one build's details · Get Builds #
Ask an LLM
“What are the details of a single build, like its version and processing state?”
“Can I fetch one specific build by its ID and pull in its related records too?”
Tell an agent
Get the details of build {build}.
Fetch build {build} and include {include}.
PATCH /v1/builds/{id} Update a build's settings · Update Builds #
Ask an LLM
“How do I change attributes on a build, such as marking it expired or setting its encryption flag?”
“Can I edit a build after it has been uploaded?”
Tell an agent
Update build {build} with {changes}.
Expire build {build} by setting {changes} on it.
GET /v1/builds/{id}/relationships/app Get the app ID a build belongs to · Get Related Builds / App #
Ask an LLM
“Which app ID does a given build belong to, without loading the whole app record?”
“Can I get just the app linkage for a build?”
Tell an agent
Give me only the app ID linked to build {build}.
Return the app relationship identifier for build {build}.
GET /v1/builds/{id}/app Get the full app record for a build · Get Related Builds / App #
Ask an LLM
“What app is this build for, with its name and bundle ID?”
“Can I load the full app details starting from a build?”
Tell an agent
Show the full app details for the app that build {build} was uploaded to.
Fetch the app object behind build {build} with fields {fields}.
GET /v1/builds/{id}/relationships/appEncryptionDeclaration Get the encryption declaration ID for a build · Get Related Builds / App Encryption Declaration #
Ask an LLM
“Which export-compliance encryption declaration ID is attached to my build?”
“Is there an encryption declaration linked to this build at all?”
Tell an agent
Return only the encryption declaration ID linked to build {build}.
Check whether build {build} has an encryption declaration linkage.
PATCH /v1/builds/{id}/relationships/appEncryptionDeclaration Attach an encryption declaration to a build · Update Related Builds / App Encryption Declaration #
Ask an LLM
“How do I assign an existing export-compliance encryption declaration to a build?”
“Can I swap which encryption declaration a build points to?”
Tell an agent
Link encryption declaration {declaration} to build {build}.
Point build {build} at a different encryption declaration: {declaration}.
GET /v1/builds/{id}/appEncryptionDeclaration Get a build's full encryption declaration · Get Related Builds / App Encryption Declaration #
Ask an LLM
“What does the encryption declaration on my build actually say about exempt or proprietary crypto?”
“Can I read the full export-compliance declaration starting from a build?”
Tell an agent
Show the full encryption declaration details for build {build}.
Fetch the export compliance declaration record attached to build {build}.
GET /v1/builds/{id}/relationships/appStoreVersion Get the App Store version ID tied to a build · Get Related Builds / App Store Version #
Ask an LLM
“Which App Store version ID is this build attached to?”
“Can I see just the version linkage for a build without its details?”
Tell an agent
Return only the App Store version ID that build {build} is linked to.
Look up the version relationship identifier for build {build}.
GET /v1/builds/{id}/appStoreVersion Get the full App Store version for a build · Get Related Builds / App Store Version #
Ask an LLM
“What App Store version is this build going out with, including its version string and state?”
“Can I load the full App Store version record from a build?”
Tell an agent
Show the App Store version details that build {build} is submitted with.
Fetch the full release version record behind build {build}.
GET /v1/builds/{id}/relationships/betaAppReviewSubmission Get the beta review submission ID for a build · Get Related Builds / Beta App Review Submission #
Ask an LLM
“Has this build been submitted for TestFlight beta review, and what's the submission ID?”
“Can I get only the beta app review submission linkage for a build?”
Tell an agent
Return the beta review submission ID linked to build {build}.
Check if build {build} has a beta app review submission link.
GET /v1/builds/{id}/betaAppReviewSubmission Get a build's beta app review submission status · Get Related Builds / Beta App Review Submission #
Ask an LLM
“What is the TestFlight beta review state of my build right now?”
“Can I see the full beta app review submission record for a build?”
Tell an agent
Show the beta app review submission details and state for build {build}.
Fetch the full external testing review submission for build {build}.
GET /v1/builds/{id}/relationships/betaBuildLocalizations List beta build localization IDs for a build · List Related Builds / Beta Build Localizations #
Ask an LLM
“Which beta build localization IDs exist for this build?”
“Can I get just the IDs of the localized What to Test notes on a build?”
Tell an agent
List only the beta build localization IDs for build {build}.
Return up to {limit} localization identifiers linked to build {build}.
GET /v1/builds/{id}/betaBuildLocalizations List a build's localized What to Test notes · List Related Builds / Beta Build Localizations #
Ask an LLM
“What did I write in the What to Test notes for each language on this build?”
“Can I read every localized TestFlight note attached to a build?”
Tell an agent
Show the full beta build localizations, with their What to Test text, for build {build}.
Fetch the localized tester notes on build {build}.
POST /v1/builds/{id}/relationships/betaGroups Add a build to beta groups · Add Related Builds / Beta Groups #
Ask an LLM
“How do I give a TestFlight beta group access to a new build?”
“Can I add one build to several beta groups at once?”
Tell an agent
Add build {build} to beta groups {groups}.
Share build {build} with tester group {groups}.
DELETE /v1/builds/{id}/relationships/betaGroups Remove a build from beta groups · Remove Related Builds / Beta Groups #
Ask an LLM
“How do I stop a TestFlight beta group from getting a particular build?”
“Can I pull a build back from some beta groups but leave it in others?”
Tell an agent destructive · confirm first
Remove build {build} from beta groups {groups}.
Revoke tester group {groups} access to build {build}.
GET /v1/builds/{id}/relationships/buildBetaDetail Get the beta detail ID for a build · Get Related Builds / Build Beta Detail #
Ask an LLM
“What's the ID of the build beta detail record for my build?”
“Can I fetch only the beta detail linkage of a build?”
Tell an agent
Return only the build beta detail ID for build {build}.
Look up which beta detail identifier is linked to build {build}.
GET /v1/builds/{id}/buildBetaDetail Get a build's TestFlight beta details · Get Related Builds / Build Beta Detail #
Ask an LLM
“Is my build set to auto-notify testers, and what is its internal and external beta state?”
“Where can I see the full TestFlight beta settings for one build?”
Tell an agent
Show the full TestFlight beta detail settings for build {build}.
Fetch internal and external testing state for build {build}.
GET /v1/builds/{id}/relationships/diagnosticSignatures List diagnostic signature IDs for a build · List Related Builds / Diagnostic Signatures #
Ask an LLM
“Which diagnostic signature IDs have been recorded against a build?”
“Can I get just the IDs of hang and disk-write signatures for a build?”
Tell an agent
List only the diagnostic signature IDs for build {build}.
Return up to {limit} diagnostic signature identifiers for build {build}.
GET /v1/builds/{id}/diagnosticSignatures List performance diagnostic signatures for a build · List Related Builds / Diagnostic Signatures #
Ask an LLM
“What performance problems, like hangs or excessive disk writes, has this build been flagged for?”
“Can I see full diagnostic signatures with their weights for a build?”
Tell an agent
Show the full diagnostic signatures reported for build {build}.
List diagnostic signatures of type {type} for build {build}.
GET /v1/builds/{id}/relationships/icons List icon IDs for a build · List Related Builds / Icons #
Ask an LLM
“Which icon IDs are attached to a build?”
“Can I get just the identifiers of a build's icons?”
Tell an agent
List only the icon IDs linked to build {build}.
Return the icon relationship identifiers for build {build}.
GET /v1/builds/{id}/icons List the app icons shipped in a build · List Related Builds / Icons #
Ask an LLM
“What app icons were included in a build I uploaded?”
“Can I see the full icon assets and their types for a build?”
Tell an agent
Show the full icon assets bundled in build {build}.
Fetch icon image details for build {build}.
GET /v1/builds/{id}/relationships/individualTesters List IDs of individual testers on a build · List Related Builds / Individual Testers #
Ask an LLM
“Which tester IDs were given access to this build individually?”
“Can I get just the IDs of testers assigned directly to a build?”
Tell an agent
List only the IDs of individual testers on build {build}.
Return up to {limit} individually assigned tester identifiers for build {build}.
POST /v1/builds/{id}/relationships/individualTesters Give individual testers access to a build · Add Related Builds / Individual Testers #
Ask an LLM
“How do I let specific beta testers try a build without adding them to a group?”
“Can I assign several testers directly to one build?”
Tell an agent
Give testers {testers} individual access to build {build}.
Assign build {build} directly to beta tester {testers}.
DELETE /v1/builds/{id}/relationships/individualTesters Remove individual testers from a build · Remove Related Builds / Individual Testers #
Ask an LLM
“How do I take away a specific tester's access to one build?”
“Can I remove testers I added individually to a build without touching groups?”
Tell an agent destructive · confirm first
Remove individual testers {testers} from build {build}.
Revoke beta tester {testers} direct access to build {build}.
GET /v1/builds/{id}/individualTesters List individual testers with access to a build · List Related Builds / Individual Testers #
Ask an LLM
“Who are the testers, by name and email, who have direct access to this build?”
“Can I see full tester profiles for everyone individually assigned to a build?”
Tell an agent
Show names and emails of the individual testers on build {build}.
Fetch full tester records for people directly assigned to build {build}.
GET /v1/builds/{id}/perfPowerMetrics Get power and performance metrics for a build · List Related Builds / Perf Power Metrics #
Ask an LLM
“What are the battery, launch time and memory metrics for a specific build?”
“Can I filter a build's performance metrics by device type or platform?”
Tell an agent
Get power and performance metrics for build {build}.
Show {metric} metrics for build {build} on device type {device}.
GET /v1/builds/{id}/relationships/preReleaseVersion Get the prerelease version ID of a build · Get Related Builds / Pre Release Version #
Ask an LLM
“Which prerelease version ID does this build sit under?”
“Can I get only the prerelease version linkage for a build?”
Tell an agent
Return only the prerelease version ID for build {build}.
Look up the prerelease version relationship of build {build}.
GET /v1/builds/{id}/preReleaseVersion Get the full prerelease version for a build · Get Related Builds / Pre Release Version #
Ask an LLM
“What prerelease version number and platform is this TestFlight build filed under?”
“Can I load the full prerelease version record from a build?”
Tell an agent
Show the prerelease version number and platform for build {build}.
Fetch the full prerelease train that build {build} belongs to.
GET /v1/builds/{id}/metrics/betaBuildUsages Get beta usage metrics for a build · Get Metrics Builds / Beta Build Usages #
Ask an LLM
“How many TestFlight testers installed, opened or crashed on a given build?”
“What beta usage numbers, like sessions and feedback counts, does a build have?”
Tell an agent
Get beta usage metrics for build {build}.
Show up to {limit} groups of TestFlight usage data for build {build}.

Documentation

📖
Documentation
https://developer.apple.com/documentation/appstoreconnectapi
📖
APIReference
https://developer.apple.com/documentation/appstoreconnectapi
📖
GettingStarted
https://developer.apple.com/documentation/appstoreconnectapi/creating-api-keys-for-app-store-connect-api
📖
Authentication
https://developer.apple.com/documentation/appstoreconnectapi/generating-tokens-for-api-requests

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-builds-api-openapi.yml

Other Resources

🔗
ReleaseNotes
https://developer.apple.com/documentation/appstoreconnectapi/app-store-connect-api-release-notes
🔗
SDKs
https://github.com/apple/app-store-server-library-swift
🔗
SDKs
https://github.com/apple/app-store-server-library-java
🔗
SDKs
https://github.com/apple/app-store-server-library-python
🔗
SDKs
https://github.com/apple/app-store-server-library-node

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ios:ios-builds-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ios-builds-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: App Store Connect Builds API
  version: 4.3.1
  x-platforms:
    app_store_connect_api: App Store Connect API
  description: The App Store Connect API is the standards-based REST API Apple provides to automate tasks across App Store Connect, Xcode, and Certificates, Identifiers & Profiles.
servers:
- url: https://api.appstoreconnect.apple.com/
security:
- itc-bearer-token: []
tags:


# --- truncated at 32 KB (202 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-builds-api-openapi.yml