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.

integer

Maximum results per page (1-200)

string

Next page URL from a previous response

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.

string

required

App Store Connect app ID (or ASC_APP_ID env variable)

string

Filter by territory (e.g., USA)

integer

Maximum results per page (1-200)

string

Next page URL from a previous response

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.

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.

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.

string

App Store Connect app ID (or ASC_APP_ID env variable)

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.

string

required

App Store Connect app ID

string

required

App price point ID

string

required

Base territory code (e.g., USA)

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.

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.

string

required

App price schedule ID

Examples:

asc pricing schedule automatic-prices --schedule "SCHEDULE_ID"

`asc pricing availability view`

View app availability.

string

App Store Connect app ID (or ASC_APP_ID env variable)

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.

string

required

App Store Connect app ID

string

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

boolean

default:"false"

Apply to all territories instead of --territory

boolean

required

Set availability (true or false)

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.

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

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

Pricing

Pricing Commands

Overview

Commands

`asc pricing territories list`

`asc pricing price-points`

`asc pricing price-points view`

`asc pricing price-points equalizations`

`asc pricing tiers`

`asc pricing schedule view`

`asc pricing schedule create`

`asc pricing schedule manual-prices`

`asc pricing schedule automatic-prices`

`asc pricing availability view`

`asc pricing availability edit`

`asc pricing availability territory-availabilities`

Common Usage Patterns

List all territories

Get price points for a specific territory

Create a price schedule

Edit app availability

Check current pricing schedule

Territory Codes

Pricing Tiers

Manual vs Automatic Prices

​Pricing Commands

​Overview

​Commands

​asc pricing territories list

​asc pricing price-points

​asc pricing price-points view

​asc pricing price-points equalizations

​asc pricing tiers

​asc pricing schedule view

​asc pricing schedule create

​asc pricing schedule manual-prices

​asc pricing schedule automatic-prices

​asc pricing availability view

​asc pricing availability edit

​asc pricing availability territory-availabilities

​Common Usage Patterns

​List all territories

​Get price points for a specific territory

​Create a price schedule

​Edit app availability

​Check current pricing schedule

​Territory Codes

​Pricing Tiers

​Manual vs Automatic Prices

Pricing Commands

Overview

Commands

`asc pricing territories list`

`asc pricing price-points`

`asc pricing price-points view`

`asc pricing price-points equalizations`

`asc pricing tiers`

`asc pricing schedule view`

`asc pricing schedule create`

`asc pricing schedule manual-prices`

`asc pricing schedule automatic-prices`

`asc pricing availability view`

`asc pricing availability edit`

`asc pricing availability territory-availabilities`

Common Usage Patterns

List all territories

Get price points for a specific territory

Create a price schedule

Edit app availability

Check current pricing schedule

Territory Codes

Pricing Tiers

Manual vs Automatic Prices