Skip to main content

status

Release pipeline dashboard for an app
The status command aggregates App Store release signals into one deterministic payload for CI, agents, and human review.

Usage

asc status [flags]

What It Includes

Use --include to choose which sections to fetch:
  • app
  • builds
  • testflight
  • appstore
  • submission
  • review
  • phased-release
  • links

Examples

asc status --app "123456789"
asc status --app "com.example.app"
asc status --app "My App"
asc status --app "123456789" --include builds,testflight,submission
asc status --app "123456789" --watch --poll-interval 15s
asc status --app "123456789" --output table

Flags

--app
string
required
App Store Connect app ID, bundle ID, or exact app name (required, or ASC_APP_ID)
--include
string
Comma-separated sections: app, builds, testflight, appstore, submission, review, phased-release, links
--watch
boolean
default:"false"
Poll and emit snapshots when status changes
--poll-interval
string
default:"30s"
Polling interval for --watch
--max-polls
integer
default:"0"
Maximum polls for --watch (0 = unlimited)
--output
string
default:"json"
Output format: json, table, markdown

Typical Uses

Check release health once

asc status --app "123456789" --output table

Watch review and submission progress

asc status \
  --app "123456789" \
  --include submission,review,appstore \
  --watch \
  --poll-interval 30s

Feed structured output into CI or automation

asc status --app "123456789" --output json

Release command

Stage an App Store release before submission

Publish command

Run the canonical App Store upload + submit workflow

Review command

Inspect app-scoped review state and blockers directly