Skip to main content

​
Overview

Pricing commands manage app pricing, price schedules, and territory availability.

​
Commands

​
asc pricing territories list

List territories in App Store Connect.
​
--limit
integer
Maximum results per page (1-200)
​
--next
string
Next page URL from a previous response
​
--paginate
boolean
default:"false"
Automatically fetch all pages
Examples: 
asc pricing territories list
asc pricing territories list --paginate
Response: 
{
  "data": [
    {
      "id": "USA",
      "type": "territories",
      "attributes": {
        "currency": "USD"
      }
    },
    {
      "id": "GBR",
      "type": "territories",
      "attributes": {
        "currency": "GBP"
      }
    }
  ]
}

​
asc pricing price-points

List app price points for an app.
​
--app
string
required
App Store Connect app ID (or ASC_APP_ID env variable)
​
--territory
string
Filter by territory (e.g., USA)
​
--limit
integer
Maximum results per page (1-200)
​
--next
string
Next page URL from a previous response
​
--paginate
boolean
default:"false"
Automatically fetch all pages
Examples: 
asc pricing price-points --app "123456789"
asc pricing price-points --app "123456789" --territory "USA"
asc pricing price-points --app "123456789" --paginate
Response: 
{
  "data": [
    {
      "id": "PRICE_POINT_ID",
      "type": "appPricePoints",
      "attributes": {
        "customerPrice": "0.99",
        "proceeds": "0.70"
      }
    }
  ]
}

​
asc pricing price-points get

Get a single app price point.
​
--price-point
string
required
App price point ID
Examples: 
asc pricing price-points get --price-point "PRICE_POINT_ID"

​
asc pricing price-points equalizations

List equalized price points for a price point.
​
--price-point
string
required
App price point ID
Examples: 
asc pricing price-points equalizations --price-point "PRICE_POINT_ID"

​
asc pricing tiers

List pricing tiers. Examples: 
asc pricing tiers --app "123456789" --territory "USA"

​
asc pricing schedule get

Get the current app price schedule.
​
--app
string
App Store Connect app ID (or ASC_APP_ID env variable)
​
--id
string
App price schedule ID
Either --app or --id must be provided, but not both.
Examples: 
asc pricing schedule get --app "123456789"
asc pricing schedule get --id "SCHEDULE_ID"
Response: 
{
  "data": {
    "id": "SCHEDULE_ID",
    "type": "appPriceSchedules",
    "relationships": {
      "app": {
        "data": {
          "id": "123456789",
          "type": "apps"
        }
      }
    }
  }
}

​
asc pricing schedule create

Create an app price schedule.
​
--app
string
required
App Store Connect app ID
​
--price-point
string
required
App price point ID
​
--base-territory
string
required
Base territory code (e.g., USA)
​
--start-date
string
required
Start date (YYYY-MM-DD)
Examples: 
asc pricing schedule create --app "123456789" --price-point "PRICE_POINT_ID" --base-territory "USA" --start-date "2024-03-01"

​
asc pricing schedule manual-prices

List manual prices for a schedule.
​
--schedule
string
required
App price schedule ID
Examples: 
asc pricing schedule manual-prices --schedule "SCHEDULE_ID"

​
asc pricing schedule automatic-prices

List automatic prices for a schedule.
​
--schedule
string
required
App price schedule ID
Examples: 
asc pricing schedule automatic-prices --schedule "SCHEDULE_ID"

​
asc pricing availability get

Get app availability.
​
--app
string
App Store Connect app ID (or ASC_APP_ID env variable)
​
--id
string
App availability ID
Either --app or --id must be provided, but not both.
Examples: 
asc pricing availability get --app "123456789"
asc pricing availability get --id "AVAILABILITY_ID"
Response: 
{
  "data": {
    "id": "AVAILABILITY_ID",
    "type": "appAvailabilities",
    "attributes": {
      "availableInNewTerritories": true
    }
  }
}

​
asc pricing availability set

Set app availability for territories.
​
--app
string
required
App Store Connect app ID
​
--territory
string
required
Territory codes (comma-separated, e.g., USA,GBR,DEU)
​
--available
boolean
required
Set availability (true or false)
​
--available-in-new-territories
boolean
Automatically make available in new territories
Examples: 
asc pricing availability set --app "123456789" --territory "USA,GBR,DEU" --available true --available-in-new-territories true
asc pricing availability set --app "123456789" --territory "CHN" --available false

​
asc pricing availability territory-availabilities

List territory availabilities for an app availability.
​
--availability
string
required
App availability ID
Examples: 
asc pricing availability territory-availabilities --availability "AVAILABILITY_ID"

​
Common Usage Patterns

​
List all territories

asc pricing territories list --paginate --output table

​
Get price points for a specific territory

asc pricing price-points --app "123456789" --territory "USA" --output json

​
Create a price schedule

asc pricing schedule create --app "123456789" --price-point "PRICE_POINT_ID" --base-territory "USA" --start-date "2024-03-01"

​
Set app availability

asc pricing availability set --app "123456789" --territory "USA,GBR,DEU,FRA" --available true --available-in-new-territories true

​
Check current pricing schedule

asc pricing schedule get --app "123456789" --output json

​
Territory Codes

Common territory codes:
  • USA - United States
  • GBR - United Kingdom
  • DEU - Germany
  • FRA - France
  • JPN - Japan
  • CHN - China
  • CAN - Canada
  • AUS - Australia
Use asc pricing territories list to see all available territories.

​
Pricing Tiers

App Store pricing uses a tier system where each tier corresponds to a price in each territory’s currency. When you set a price in your base territory, equivalent prices are automatically set in all other territories.

​
Manual vs Automatic Prices

  • Automatic Prices: Prices are automatically equalized across all territories based on the base territory price
  • Manual Prices: You can set specific prices for individual territories that override the automatic equalization