| name | asc-availability |
| description | Manage app, IAP, and subscription territory availability using the `asc` CLI tool.
Use this skill when:
(1) Listing all App Store territories: "asc territories list"
(2) Getting app territory availability with per-territory status: "asc app-availability get --app-id ID"
(3) Getting IAP territory availability: "asc iap-availability get --iap-id ID"
(4) Creating IAP territory availability: "asc iap-availability create --iap-id ID --available-in-new-territories --territory USA"
(5) Getting subscription territory availability: "asc subscription-availability get --subscription-id ID"
(6) Creating subscription territory availability: "asc subscription-availability create --subscription-id ID --available-in-new-territories --territory USA"
(7) User says "territory availability", "app availability", "iap availability", "subscription availability",
"which territories", "available in new territories", "list territories",
"set territory", "territory management", "where is my app available",
"why can't I sell in this country", "blocked territory", "content status",
"make available in all countries", "restrict to specific markets",
"check availability", "which countries", "which markets", "pre-order territory"
|
App, IAP & Subscription Territory Availability
Manage which App Store territories (countries/regions) an app, in-app purchase, or subscription is available in. This is essential for controlling regional distribution — for example, understanding why your app is blocked in certain countries, restricting a subscription to specific markets, or making an IAP available worldwide.
App Availability (Per-Territory Status)
The richest availability view — shows every territory with isAvailable (true/false), blocking reasons via contentStatuses, releaseDate, and isPreOrderEnabled.
asc app-availability get --app-id <APP_ID> [--pretty]
This returns all ~175 territories with their status. Key contentStatuses values:
AVAILABLE — selling normallyCANNOT_SELL_RESTRICTED_RATING — age rating blocks sale in this territoryMISSING_RATING — no age rating configuredICP_NUMBER_MISSING — China requires ICP numberBRAZIL_REQUIRED_TAX_ID — Brazil requires tax IDCANNOT_SELL_GAMBLING / CANNOT_SELL_CASINO — gambling restrictions- 30+ more specific blocking reasons
List All Territories
Before setting availability, discover valid territory IDs. Apple has ~175 territories, each with an ISO-style ID (e.g. USA, CHN, JPN) and a currency code.
asc territories list [--output table] [--pretty]
Example output:
ID Currency
USA USD
CHN CNY
JPN JPY
GBR GBP
DEU EUR
...
IAP Availability
Get Current IAP Availability
Check which territories an IAP is currently available in. The response includes each territory's currency code.
asc iap-availability get --iap-id <IAP_ID> [--pretty]
Example JSON response:
{
"data": [
{
"id": "avail-1",
"iapId": "iap-42",
"isAvailableInNewTerritories": true,
"territories": [
{ "id": "USA", "currency": "USD" },
{ "id": "CHN", "currency": "CNY" }
],
"affordances": {
"getAvailability": "asc iap-availability get --iap-id iap-42",
"createAvailability": "asc iap-availability create --iap-id iap-42 ...",
"listTerritories": "asc territories list"
Create IAP Availability
Set which territories an IAP should be available in. Use --territory (repeatable) to specify each territory ID, and --available-in-new-territories to automatically include any new territories Apple adds in the future.
asc iap-availability create \
--iap-id <IAP_ID> \
--available-in-new-territories \
--territory USA \
--territory CHN \
--territory JPN
| Flag | Required | Description |
|---|
--iap-id | Yes | IAP ID to set availability for |
--available-in-new-territories | No | Auto-include new territories Apple adds |
--territory | No | Territory ID (repeatable). Use asc territories list to find valid IDs |
Subscription Availability
Get Current Subscription Availability
asc subscription-availability get --subscription-id <SUB_ID> [--pretty]
Create Subscription Availability
asc subscription-availability create \
--subscription-id <SUB_ID> \
--available-in-new-territories \
--territory USA \
--territory GBR
| Flag | Required | Description |
|---|
--subscription-id | Yes | Subscription ID to set availability for |
--available-in-new-territories | No | Auto-include new territories Apple adds |
--territory | No | Territory ID (repeatable) |
CAEOAS Affordances
Every availability response includes ready-to-run follow-up commands:
{
"affordances": {
"getAvailability": "asc iap-availability get --iap-id <ID>",
"createAvailability": "asc iap-availability create --iap-id <ID> ...",
"listTerritories": "asc territories list"
}
}
The InAppPurchase and Subscription models also include a getAvailability affordance for navigation from the parent resource.
Resolve App ID
See project-context.md — check .asc/project.json before asking the user or running asc apps list.
Typical Workflow
APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
asc territories list --output table
asc iap list --app-id "$APP_ID"
asc iap-availability get --iap-id "$IAP_ID" --pretty
asc iap-availability create --iap-id "$IAP_ID" \
--available-in-new-territories \
--territory USA --territory GBR --territory DEU --territory JPN
asc subscriptions list --group-id "$GROUP_ID"
asc subscription-availability get --subscription-id "$SUB_ID"
asc subscription-availability create --subscription-id "$SUB_ID" \
--available-in-new-territories \
--territory USA --territory CHN
Key Concepts
- Territory ID: ISO-style country code used by App Store Connect (e.g.
USA, CHN, JPN, GBR). Use asc territories list to see all valid IDs.
isAvailableInNewTerritories: When true, Apple automatically makes the IAP/subscription available in any new territory they add. Recommended for most apps unless you need tight regional control.- Currency: Each territory has an associated currency (e.g.
USD, CNY). Shown alongside territory IDs in availability responses so you know the pricing context.
