Skip to main content

List Apps

GET /v1/connect/apps
List apps in your App Store Connect account. Filter by bundle ID to find a specific app.

Headers

HeaderRequiredDescription
X-ASC-Issuer-IdYesYour Issuer ID
X-ASC-Key-IdYesYour Key ID
X-ASC-Private-KeyYes*Your private key (PEM)

Query Parameters

NameTypeDefaultDescription
bundleIdstringFilter by bundle ID (e.g. app.taperecord)
limitinteger50Max results (1-200)
cursorstringPagination cursor

Response

{
  "data": {
    "data": [
      {
        "type": "apps",
        "id": "6759740679",
        "attributes": {
          "name": "Voice Tape Record",
          "bundleId": "app.taperecord",
          "sku": "apptaperecord",
          "primaryLocale": "en-US"
        }
      }
    ],
    "meta": { "paging": { "total": 1, "limit": 50 } }
  }
}

Get App

GET /v1/connect/apps/:appId
Get details for a specific app by its App Store Connect app ID.

Path Parameters

NameTypeDescription
appIdstringApp Store Connect app ID (numeric, e.g. 6759740679)

Response

Returns the app object with name, bundleId, sku, primaryLocale.

List App Infos

GET /v1/connect/apps/:appId/app-infos
List App Info resources for an app. App Info resources are used for app-level localizable fields such as name and subtitle.

Path Parameters

NameTypeDescription
appIdstringApp Store Connect app ID (numeric, e.g. 6759740679)

Query Parameters

NameTypeDefaultDescription
limitinteger50Max results (1-200)
cursorstringPagination cursor

Response Fields

FieldDescription
appStoreStateApp-level state for the App Info resource

List App Info Localizations

GET /v1/connect/app-infos/:appInfoId/localizations
List localizations for an App Info resource. This includes app-level localized fields like name and subtitle.

Path Parameters

NameTypeDescription
appInfoIdstringApp Info ID from GET /v1/connect/apps/:appId/app-infos

Response Fields

FieldDescription
localeLocalization code (e.g. en-US, tr)
nameLocalized app name
subtitleLocalized subtitle shown in App Information
privacyPolicyTextPrivacy policy text for that locale (if available)

Update App Info Localization

PATCH /v1/connect/app-info-localizations/:localizationId
Update app-level localized fields. Use this endpoint to update fields visible under App Information in App Store Connect (such as subtitle).

Path Parameters

NameTypeDescription
localizationIdstringApp Info Localization ID

Request Body

{
  "attributes": {
    "name": "Voice Tape Record",
    "subtitle": "Audio recording & a retro VHS"
  }
}
AttributeTypeDescription
namestringLocalized app name
subtitlestringLocalized subtitle
privacyPolicyTextstringLocalized privacy policy text

List Versions

GET /v1/connect/apps/:appId/versions
List App Store versions for an app. Returns version string, platform, state, release type, and dates.

Query Parameters

NameTypeDefaultDescription
platformstringFilter: IOS, MAC_OS, TV_OS
limitinteger50Max results (1-200)
cursorstringPagination cursor

Response Fields

FieldDescription
versionStringVersion number (e.g. 1.1)
platformIOS, MAC_OS, or TV_OS
appStoreStatePREPARE_FOR_SUBMISSION, READY_FOR_SALE, REJECTED, etc.
releaseTypeMANUAL, AFTER_APPROVAL, SCHEDULED
earliestReleaseDateScheduled release date (if applicable)
createdDateWhen the version was created

Create Version

POST /v1/connect/apps/:appId/versions
Create a new App Store version for an app.

Request Body

{
  "versionString": "1.2",
  "platform": "IOS"
}
FieldTypeRequiredDescription
versionStringstringYesVersion number (e.g. 1.2, 2.0)
platformstringYesIOS, MAC_OS, or TV_OS

Update Version

PATCH /v1/connect/versions/:versionId
Update version-level attributes.

Request Body

{
  "attributes": {
    "versionString": "1.2",
    "copyright": "2026 Your Company",
    "releaseType": "MANUAL",
    "earliestReleaseDate": "2026-03-15T00:00:00Z",
    "downloadable": true
  }
}
AttributeTypeDescription
versionStringstringVersion number
copyrightstringCopyright notice
releaseTypestringMANUAL, AFTER_APPROVAL, SCHEDULED
earliestReleaseDatestringISO 8601 date for scheduled release
downloadablebooleanWhether the version is downloadable

Code Example

# Find app by bundle ID
curl -X GET "https://api.appeeky.com/v1/connect/apps?bundleId=app.taperecord" \
  -H "X-API-Key: YOUR_APEEKY_KEY" \
  -H "X-ASC-Issuer-Id: YOUR_ISSUER_ID" \
  -H "X-ASC-Key-Id: YOUR_KEY_ID" \
  -H "X-ASC-Private-Key: YOUR_PRIVATE_KEY"

# List versions
curl -X GET "https://api.appeeky.com/v1/connect/apps/6759740679/versions" \
  -H "X-API-Key: YOUR_APEEKY_KEY" \
  -H "X-ASC-Issuer-Id: YOUR_ISSUER_ID" \
  -H "X-ASC-Key-Id: YOUR_KEY_ID" \
  -H "X-ASC-Private-Key: YOUR_PRIVATE_KEY"