Parsequerade / docs
Apps
GET/apps/{appId}

Implemented · First release · Operator configuration and deployment required

Request

Routes are relative to your connection. Use a facade API key; the service manages Apple authentication.

cURL
BASE='https://asc.example.com/v1/connections/conn_example'

curl --fail-with-body "$BASE/apps/1234567890" \
  -H "Authorization: Bearer $ASC_FACADE_KEY"

asc.example.com is a placeholder for your deployment. Examples use fictional IDs.

Path parameters

NameTypeDescription
appIdRequiredstringApple’s app ID. Returned by List apps.

Query parameters

NameTypeDescription
fieldsOptionalstringComma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.
ValuesaccessibilityUrl, name, bundleId, sku, primaryLocale, isOrEverWasMadeForKids, subscriptionStatusUrl, subscriptionStatusUrlVersion, subscriptionStatusUrlForSandbox, subscriptionStatusUrlVersionForSandbox, contentRightsDeclaration, streamlinedPurchasingEnabled

Response

One flat object for the selected resource.

200 · application/json
{
  "id": "1234567890",
  "accessibilityUrl": "https://example.com/asset",
  "name": "Example Notes",
  "bundleId": "com.example.notes",
  "sku": "example-ios",
  "primaryLocale": "en-US"
}

Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.

Response fields

NameTypeDescription
idstringApple’s resource ID. Keep this string unchanged when addressing a resource.
accessibilityUrlstring · uri | nullThe app’s accessibility-information website.
namestring | nullThe resource’s name. An app’s localized name is read from its app-info localization.
bundleIdstring | nullThe app’s bundle identifier, such as com.example.notes.
skustring | nullThe identifier you assigned to the app in App Store Connect.
primaryLocalestring | nullThe app’s primary locale. It does not cause automatic locale fallback.
isOrEverWasMadeForKidsboolean | nullWhether Apple records this app as having been made for kids.
subscriptionStatusUrlstring · uri | nullThe production server-notification URL configured for subscriptions.
subscriptionStatusUrlVersionstring | nullThe notification payload version configured for production.
ValuesV1, V2
subscriptionStatusUrlForSandboxstring · uri | nullThe sandbox server-notification URL configured for subscriptions.
subscriptionStatusUrlVersionForSandboxstring | nullThe notification payload version configured for the sandbox.
ValuesV1, V2
contentRightsDeclarationstring | nullWhether the app uses third-party content.
ValuesDOES_NOT_USE_THIRD_PARTY_CONTENT, USES_THIRD_PARTY_CONTENT
streamlinedPurchasingEnabledboolean | nullWhether the app has streamlined purchasing enabled.
appStoreIconIdOptional linkagestring | nullID of the related app store icon. Present only when Apple supplies linkage; related objects are not loaded automatically.
ciProductIdOptional linkagestring | nullID of the related ci product. Present only when Apple supplies linkage; related objects are not loaded automatically.
betaLicenseAgreementIdOptional linkagestring | nullID of the related beta license agreement. Present only when Apple supplies linkage; related objects are not loaded automatically.
betaAppReviewDetailIdOptional linkagestring | nullID of the related beta app review detail. Present only when Apple supplies linkage; related objects are not loaded automatically.
endUserLicenseAgreementIdOptional linkagestring | nullID of the related end user license agreement. Present only when Apple supplies linkage; related objects are not loaded automatically.
subscriptionGracePeriodIdOptional linkagestring | nullID of the related subscription grace period. Present only when Apple supplies linkage; related objects are not loaded automatically.
gameCenterDetailIdOptional linkagestring | nullID of the related game center detail. Present only when Apple supplies linkage; related objects are not loaded automatically.

Behavior

  • A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data.

Errors

HTTPTypeDescription
400invalid_queryUnsupported filter, sort, limit, or cursor.
401unauthorizedMissing or invalid facade API key.
403forbidden / upstream_forbiddenThe caller or configured Apple key cannot read this resource.
404resource_not_foundThe requested resource, parent, or exact locale is absent or outside the caller’s scope.
429rate_limitedA facade or Apple rate limit was reached. Respect Retry-After when returned.
502–504upstream errorApple authentication, response parsing, availability, or timeout failure; this is not an empty result.

Apple mapping

Upstream route and translation

The adapter calls GET /v1/apps/{id}. Read Apple’s original endpoint ↗

Flatten Apple’s attributes into each resource object. Expose supplied singleton linkage as IDs, with no automatic relationship traversal. Read access does not make these fields writable.

Facade parameterTypeDescription
fieldsqueryfields[apps]

Reviewed 2026-10-14 · OpenAPI 4.5.1