Skip to main content

​
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.
​
--bundle-id
string
Filter by bundle ID(s), comma-separated
​
--name
string
Filter by app name(s), comma-separated
​
--sku
string
Filter by SKU(s), comma-separated
​
--sort
string
Sort by: name, -name, bundleId, -bundleId
​
--limit
integer
Maximum results per page (1-200)
​
--next
string
Fetch next page using a links.next URL
​
--paginate
boolean
default:"false"
Automatically fetch all pages (aggregate results)
​
--output
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.
​
--id
string
required
App Store Connect app ID
​
--output
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.
​
--id
string
required
App Store Connect app ID
​
--bundle-id
string
Update bundle ID
​
--primary-locale
string
Update primary locale (e.g., en-US)
​
--content-rights
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 "user@example.com"

​
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