---
title: "Resolve introductory eligibility"
description: "Get the signed App Store introductory-offer decision for a purchase placement."
api: POST https://i.nuxie.ai/app-store/intro-eligibility
authMethod: none
playground: simple
search:
  tags: ["api", "app", "reference"]
  keywords: ["StoreKit", "introductory offer", "placementId", "descriptorSha256"]
---

Get a signed introductory-offer decision for an App Store purchase. The SDK supplies the purchase placement and its authenticated Journey context when it calls this endpoint.

## Request body

- **`apiKey`** · body · `string` · required

  Publishable key for the app platform. A `pk_test_` key selects test data; a `pk_live_` key selects live data. Copy it from **Connect your app**.

- **`distinctId`** · body · `string` · required

  The identified or anonymous customer ID your app supplies to the SDK, rather than Nuxie's internal customer record ID. See [Customer identifiers](/docs/api-reference/rest-api#customer-identifiers).

- **`journeyId`** · body · `string` · required

  Journey containing the purchase.

- **`experienceVersionId`** · body · `string` · required

  Published Version containing the offer.

- **`legId`** · body · `string` · required

  Journey section identifier, as a lowercase SHA-256 hash.

- **`descriptorSha256`** · body · `string` · required

  Lowercase SHA-256 hash of the release descriptor.

- **`placementId`** · body · `string` · required

  Purchase placement in the published Version.

- **`transactionId`** · body · `string` · required

  StoreKit transaction identifier used for eligibility.

All fields are required, non-empty strings of at most 255 bytes. Unknown fields are rejected. This endpoint uses camelCase field names, unlike [purchase synchronization](/docs/api-reference/app/purchase).

## Response

- **`token`** · `string` · required

  Signed introductory-offer eligibility token.

An unauthorized or unconfigured placement returns `404`. Unavailable signing credentials return `503`.

```sh title="cURL"
curl https://i.nuxie.ai/app-store/intro-eligibility \
  --header 'Content-Type: application/json' \
  --data '{
  "apiKey": "pk_test_example",
  "distinctId": "user-456",
  "journeyId": "journey-id",
  "experienceVersionId": "experience-version-id",
  "legId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "descriptorSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "placementId": "placement-id",
  "transactionId": "storekit-transaction-id"
}'
```

```json title="200"
{
  "token": "signed-eligibility-token"
}
```