Parsequerade / docs
In-App Purchases
GET/in-app-purchases/{purchaseId}

Proposed · Extended read design · Adapter not implemented

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/in-app-purchases/purchase_123" \
  -H "Authorization: Bearer $ASC_FACADE_KEY"

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

Path parameters

NameTypeDescription
purchaseIdRequiredstringThe selected resource’s ID.

Query parameters

NameTypeDescription
fieldsOptionalstringComma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.
Valuesname, productId, inAppPurchaseType, state, reviewNote, familySharable, contentHosting

Response

One flat object for the selected resource.

200 · application/json
{
  "id": "in_app_purchase_123",
  "name": "Example Notes",
  "productId": "com.example.notes.pro",
  "inAppPurchaseType": "CONSUMABLE",
  "state": "MISSING_METADATA",
  "reviewNote": "review_note_example"
}

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.
namestringThe resource’s name. An app’s localized name is read from its app-info localization.
productIdstringThe product identifier configured in App Store Connect.
inAppPurchaseTypestringThe in app purchase type value reported by Apple for this resource.
ValuesCONSUMABLE, NON_CONSUMABLE, NON_RENEWING_SUBSCRIPTION
statestringThe current state reported by Apple for this resource.
ValuesMISSING_METADATA, WAITING_FOR_UPLOAD, PROCESSING_CONTENT, READY_TO_SUBMIT, WAITING_FOR_REVIEW, IN_REVIEW, DEVELOPER_ACTION_NEEDED, PENDING_BINARY_APPROVAL, APPROVED, DEVELOPER_REMOVED_FROM_SALE, REMOVED_FROM_SALE, REJECTED
reviewNotestringThe review note attached to this purchase or subscription.
familySharablebooleanWhether the purchase is available through Family Sharing.
contentHostingbooleanWhether Apple marks this resource as content hosting.
contentIdOptional linkagestring | nullID of the related content. Present only when Apple supplies linkage; related objects are not loaded automatically.
appStoreReviewScreenshotIdOptional linkagestring | nullID of the related app store review screenshot. Present only when Apple supplies linkage; related objects are not loaded automatically.
promotedPurchaseIdOptional linkagestring | nullID of the related promoted purchase. Present only when Apple supplies linkage; related objects are not loaded automatically.
iapPriceScheduleIdOptional linkagestring | nullID of the related iap price schedule. Present only when Apple supplies linkage; related objects are not loaded automatically.
inAppPurchaseAvailabilityIdOptional linkagestring | nullID of the related in app purchase availability. 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 /v2/inAppPurchases/{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[inAppPurchases]

Reviewed 2026-10-14 · OpenAPI 4.5.1