asc-id-resolver

name	asc-id-resolver
description	Resolve App Store Connect IDs (apps, builds, app and digital-goods versions, groups, testers) from human-friendly names using asc. Use when commands require IDs.

asc id resolver

Use this skill to map names to IDs needed by other commands.

App ID

• By bundle ID or name:
  • asc apps list --bundle-id "com.example.app"
  • asc apps list --name "My App"
• Fetch everything:
  • asc apps list --paginate
• Set default:
  • ASC_APP_ID=...

Build ID

• Latest build:
  • asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS
• Recent builds:
  • asc builds list --app "APP_ID" --sort -uploadedDate --limit 5

Version ID

• asc versions list --app "APP_ID" --paginate

Digital-goods version IDs

API 4.4.1 version IDs are distinct from IAP product, subscription, and subscription-group IDs:

Resolve the owning resources first:

• IAPs: asc iap list --app "APP_ID" --paginate --output json
• Subscription groups: asc subscriptions groups list --app "APP_ID" --paginate --output json
• Subscriptions: asc subscriptions list --app "APP_ID" --paginate --output json or asc subscriptions list --group-id "GROUP_ID" --paginate --output json

Then resolve their version IDs:

• IAP versions: asc iap versions list --iap-id "IAP_ID" --paginate --output json
• Subscription versions: asc subscriptions versions list --subscription-id "SUB_ID" --paginate --output json
• Subscription group versions: asc subscriptions groups versions list --group-id "GROUP_ID" --paginate --output json

Resolve child localization or image IDs from the corresponding version subtree:

• IAP localizations: asc iap versions localizations list --version-id "VERSION_ID" --paginate --output json
• IAP primary image: asc iap versions image --version-id "VERSION_ID" --output json
• IAP image collection: asc iap versions images list --version-id "VERSION_ID" --paginate --output json
• Subscription localizations: asc subscriptions versions localizations list --version-id "VERSION_ID" --paginate --output json
• Subscription primary image: asc subscriptions versions images primary --version-id "VERSION_ID" --output json
• Subscription image collection: asc subscriptions versions images list --version-id "VERSION_ID" --paginate --output json
• Subscription-group localizations: asc subscriptions groups versions localizations list --version-id "VERSION_ID" --paginate --output json

TestFlight IDs

• Groups:
  • asc testflight groups list --app "APP_ID" --paginate
• Testers:
  • asc testflight testers list --app "APP_ID" --paginate

Pre-release version IDs

• asc testflight pre-release list --app "APP_ID" --platform IOS --paginate

Review submission IDs

• asc review submissions-list --app "APP_ID" --paginate

Output tips

• Output defaults are TTY-aware: table in a terminal and minified JSON in pipes or CI. An explicit --output wins.
• Use explicit --output json for automation and add --pretty only for human-readable JSON.
• For human viewing, use --output table or --output markdown.

Guardrails

• Prefer --paginate on list commands to avoid missing IDs.
• Use --sort where available to make results deterministic.