Skip to main content

​
Review Commands

Manage App Store review details, attachments, submissions, and history
The review command uses hyphenated leaf subcommands for app-scoped review status, blocker diagnosis, review details, attachments, submissions, and submission items.

​
Overview

Common review commands: 
asc review status --app "123456789"
asc review doctor --app "123456789"
asc review details-get --id "DETAIL_ID"
asc review details-for-version --version-id "VERSION_ID"
asc review details-create --version-id "VERSION_ID" --contact-email "dev@example.com"
asc review details-update --id "DETAIL_ID" --notes "Updated review notes"
asc review attachments-list --review-detail "DETAIL_ID"
asc review attachments-get --id "ATTACHMENT_ID"
asc review attachments-upload --review-detail "DETAIL_ID" --file ./review-doc.pdf
asc review submissions-list --app "123456789"
asc review submissions-get --id "SUBMISSION_ID"
asc review submissions-create --app "123456789" --platform IOS
asc review submissions-submit --id "SUBMISSION_ID" --confirm
asc review submissions-cancel --id "SUBMISSION_ID" --confirm
asc review submissions-update --id "SUBMISSION_ID" --canceled=true
asc review submissions-items-ids --id "SUBMISSION_ID"
asc review items-get --id "ITEM_ID"
asc review items-list --submission "SUBMISSION_ID"
asc review items-add --submission "SUBMISSION_ID" --item-type appStoreVersions --item-id "VERSION_ID"
asc review items-update --id "ITEM_ID" --state READY_FOR_REVIEW
asc review items-remove --id "ITEM_ID" --confirm
asc review history --app "123456789"

​
Commands

​
asc review status

Show app-scoped App Review status and the next recommended action. Examples: 
asc review status --app "123456789"
asc review status --app "123456789" --version "1.2.3"
asc review status --app "123456789" --version-id "VERSION_ID"

​
asc review doctor

Explain why an app cannot be submitted for review. Examples: 
asc review doctor --app "123456789"
asc review doctor --app "123456789" --version "1.2.3"
asc review doctor --app "123456789" --version-id "VERSION_ID"

​
asc review submissions-list

List review submissions for an app or globally.
​
--app
string
App Store Connect app ID (or ASC_APP_ID)
​
--platform
string
Filter by platform: IOS, MAC_OS, TV_OS, VISION_OS (comma-separated)
​
--state
string
Filter by submission state (comma-separated)
​
--paginate
boolean
default:"false"
Automatically fetch all pages
Examples: 
asc review submissions-list --app "123456789"
asc review submissions-list --app "123456789" --platform IOS --state READY_FOR_REVIEW
asc review submissions-list --app "123456789" --paginate

​
asc review submissions-get

Get a review submission by ID.
​
--id
string
required
Review submission ID
Examples: 
asc review submissions-get --id "SUBMISSION_ID"

​
asc review submissions-cancel

Cancel a review submission.
​
--id
string
required
Review submission ID
​
--confirm
boolean
required
Confirm cancellation
Examples: 
asc review submissions-cancel --id "SUBMISSION_ID" --confirm

​
asc review details-update

Update App Store review details.
​
--id
string
required
App Store review detail ID
​
--contact-email
string
Contact email
​
--contact-phone
string
Contact phone
​
--notes
string
Reviewer instructions or context
​
--demo-account-required
boolean
Set true only when App Review needs demo credentials
​
--demo-account-name
string
Demo account name when demo credentials are required
​
--demo-account-password
string
Demo account password when demo credentials are required
Examples: 
asc review details-update --id "DETAIL_ID" --notes "Reviewer can use the guest flow from the welcome screen."
asc review details-update --id "DETAIL_ID" --demo-account-required=true --demo-account-name "reviewer@example.com" --demo-account-password "rotated-password" --notes "This account has full reviewer access."

​
asc review attachments-upload

Upload a review attachment.
​
--review-detail
string
required
App Store review detail ID
​
--file
string
required
Path to the attachment file
Examples: 
asc review attachments-upload --review-detail "REVIEW_DETAIL_ID" --file ./review-doc.pdf

​
asc review history

Show enriched review submission history for an app.
​
--app
string
App Store Connect app ID (or ASC_APP_ID)
​
--platform
string
Filter by platform: IOS, MAC_OS, TV_OS, VISION_OS
​
--state
string
Filter by submission state
​
--version
string
Filter by version string (for example 1.2.0)
​
--paginate
boolean
default:"false"
Automatically fetch all pages
Examples: 
asc review history --app "123456789"
asc review history --app "123456789" --platform IOS --state COMPLETE
asc review history --app "123456789" --version "1.2.0"

​
Additional Current Subcommands

The live review surface also includes:
  • asc review attachments-get
  • asc review attachments-delete
  • asc review submissions-update
  • asc review submissions-items-ids
  • asc review items-list
  • asc review items-update
  • asc review items-remove
Use asc review --help for the full current subcommand list.

Submit command

Check submission status or submit builds for App Store review

Reviews command

Manage customer reviews

Submission guide

Complete submission guide