Pricing

Pricing Commands

Manage app pricing and availability

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 view

View a single app price point.

--price-point · string · required

App price point ID

Examples:

asc pricing price-points view --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 view

View 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 view --app "123456789"
asc pricing schedule view --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 view

View 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 view --app "123456789"
asc pricing availability view --id "AVAILABILITY_ID"

Response:

{
  "data": {
    "id": "AVAILABILITY_ID",
    "type": "appAvailabilities",
    "attributes": {
      "availableInNewTerritories": true
    }
  }
}

---

asc pricing availability edit

Edit app availability for territories.

--app · string · required

App Store Connect app ID

--territory · string

Territory codes (comma-separated, e.g., USA,GBR,DEU)

--all-territories · boolean · default: "false"

Apply to all territories instead of --territory

--available · boolean · required

Set availability (true or false)

--available-in-new-territories · boolean

Automatically make available in new territories

Examples:

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

---

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"

Edit app availability

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

Check current pricing schedule

asc pricing schedule view --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