Apps

List and manage apps in App Store Connect

Overview

The apps command is the main app-management surface for App Store Connect. App creation no longer lives under asc apps in 1.0. Use asc web apps create for the unofficial web-session creation flow, and see the Migrate to 1.0 guide if you are updating older scripts.

Commands

`asc apps list`

List apps from App Store Connect.

string

Filter by bundle ID(s), comma-separated

string

Filter by app name(s), comma-separated

string

Filter by SKU(s), comma-separated

string

Sort by: name, -name, bundleId, -bundleId

integer

Maximum results per page (1-200)

string

Fetch next page using a links.next URL

boolean

default:"false"

Automatically fetch all pages (aggregate results)

string

default:"json"

Output format: json, table, markdown

Examples:

asc apps list
asc apps list --bundle-id "com.example.app"
asc apps list --name "My App"
asc apps list --limit 10
asc apps list --sort name
asc apps list --output table
asc apps list --paginate

Response:

{
  "data": [
    {
      "id": "123456789",
      "type": "apps",
      "attributes": {
        "name": "My App",
        "bundleId": "com.example.app",
        "sku": "MYAPP123",
        "primaryLocale": "en-US"
      }
    }
  ],
  "links": {
    "self": "https://api.appstoreconnect.apple.com/v1/apps?limit=10"
  }
}

`asc apps view`

View app details by ID.

string

required

App Store Connect app ID

string

default:"json"

Output format: json, table

Examples:

asc apps view --id "APP_ID"
asc apps view --id "APP_ID" --output table

Response:

{
  "data": {
    "id": "APP_ID",
    "type": "apps",
    "attributes": {
      "name": "My App",
      "bundleId": "com.example.app",
      "sku": "MYAPP123",
      "primaryLocale": "en-US",
      "contentRightsDeclaration": "DOES_NOT_USE_THIRD_PARTY_CONTENT"
    }
  }
}

`asc apps update`

Update an app’s bundle ID, primary locale, or content rights declaration.

string

required

App Store Connect app ID

string

Update bundle ID

string

Update primary locale (e.g., en-US)

string

Content rights declaration: DOES_NOT_USE_THIRD_PARTY_CONTENT or USES_THIRD_PARTY_CONTENT

Examples:

asc apps update --id "APP_ID" --bundle-id "com.example.app"
asc apps update --id "APP_ID" --primary-locale "en-US"
asc apps update --id "APP_ID" --content-rights "DOES_NOT_USE_THIRD_PARTY_CONTENT"

Response:

{
  "data": {
    "id": "APP_ID",
    "type": "apps",
    "attributes": {
      "bundleId": "com.example.app",
      "primaryLocale": "en-US",
      "contentRightsDeclaration": "DOES_NOT_USE_THIRD_PARTY_CONTENT"
    }
  }
}

`asc apps wall`

Display a visual wall of app icons and metadata. Examples:

asc apps wall

Other App Surfaces

The apps family also includes several app-scoped surfaces that are not fully expanded on this page yet:

asc apps wall - Show or contribute to the community Wall of Apps
asc apps public - Inspect public App Store storefront data
asc apps ci-product - View the CI product for an app
asc apps remove-beta-testers - Remove beta testers from an app
asc apps subscription-grace-period - Inspect an app’s subscription grace period
asc apps search-keywords - Manage raw search-keyword relationships
asc apps app-encryption-declarations - List app encryption declarations
asc apps content-rights - Manage content-rights declarations

Use asc apps --help and asc apps <subcommand> --help to inspect the current surface before scripting against a specific app workflow.

Common Usage Patterns

List all apps and filter by bundle ID

asc apps list --bundle-id "com.example.app" --output table

Create an app with the web flow

asc web apps create --name "My App" --bundle-id "com.example.myapp" --sku "MYAPP123" --apple-id "[email protected]"

View app details

asc apps view --id "123456789" --output json

Update app metadata

asc apps update --id "123456789" --primary-locale "en-GB"

Environment Variables

ASC_APP_ID - Default app ID for commands that require --app

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

Apps

Apps

Overview

Commands

`asc apps list`

`asc apps view`

`asc apps update`

`asc apps wall`

Other App Surfaces

Common Usage Patterns

List all apps and filter by bundle ID

Create an app with the web flow

View app details

Update app metadata

Environment Variables

​Apps

​Overview

​Commands

​asc apps list

​asc apps view

​asc apps update

​asc apps wall

​Other App Surfaces

​Common Usage Patterns

​List all apps and filter by bundle ID

​Create an app with the web flow

​View app details

​Update app metadata

​Environment Variables

Apps

Overview

Commands

`asc apps list`

`asc apps view`

`asc apps update`

`asc apps wall`

Other App Surfaces

Common Usage Patterns

List all apps and filter by bundle ID

Create an app with the web flow

View app details

Update app metadata

Environment Variables