<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/beta-app-review-submissions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Beta App Review Submissions"
}
-->

# Beta App Review Submissions

The submissions of builds for beta app review, including the status of submissions.

## Discussion

A `betaAppReviewSubmissions` resource represents Apple’s review of a build before its distribution through TestFlight. Create a beta app review submission when you are ready to submit a build. App Store Connect validates the beta app review submission to ensure it includes necessary information such as `appEncryptionDeclarations`, `betaAppReviewDetails`, and so on, and submits the build to the review team.

API users can get the `betaAppReviewSubmissions` to see if the build has been accepted or rejected.

## Topics

### Submitting an App for Beta Review

[`Submit an app for beta review`](/documentation/AppStoreConnectAPI/POST-v1-betaAppReviewSubmissions)

Submit an app for beta app review to allow external testing.

### Getting Beta App Review Submissions Info

[`List beta app review submissions`](/documentation/AppStoreConnectAPI/GET-v1-betaAppReviewSubmissions)

Find and list beta app review submissions for all builds.

[`Read beta app review submission information`](/documentation/AppStoreConnectAPI/GET-v1-betaAppReviewSubmissions-_id_)

Get a specific beta app review submission.

### Getting Build Information

[`Read the build information of a beta app review submission`](/documentation/AppStoreConnectAPI/GET-v1-betaAppReviewSubmissions-_id_-build)

Get the build information for a specific beta app review submission.

[`Get the build ID for a beta app review submission`](/documentation/AppStoreConnectAPI/GET-v1-betaAppReviewSubmissions-_id_-relationships-build)

### Objects and Data Types

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

A submission of a build to Apple’s beta app review process, required before external testing.

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

The request body you use to create a Beta App Review Submission.

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

The response body for endpoints that submit a build for beta app review.

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

A response containing a single beta app review submission, without related resources.

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

The response body for endpoints that list beta app review submissions.

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

String that indicates the review state of a beta app.

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


---

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)