GET
/
purchases
/
{purchase_id}
{
  "id": "purchase.cf637646-71a4-430d-aaea-a66f1a48a83c",
  "offering_id": "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9",
  "purchased_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "price": {
    "amount": 50,
    "currency": {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$",
      "base_unit": 100
    }
  },
  "status": "abandoned",
  "metadata": {},
  "entitlement_status": {
    "content_key": "site.cf637646-71a4-430d-aaea-a66f1a48a83c",
    "has_entitlement": true,
    "expires": "2023-11-07T05:31:56Z",
    "recurs_at": "2023-11-07T05:31:56Z"
  }
}

Headers

​
x-api-version
string
default:2025-04-01
Example:

"2025-04-01"

​
x-supertab-client-id
string
required
Example:

"live_client.4df706b5-297a-49c5-a4cd-2a10eca12ff9"

Path Parameters

​
purchase_id
string
required

An ID of a Purchase

Example:

"purchase.4df706b5-297a-49c5-a4cd-2a10eca12ff9"

Response

200
application/json
Successful Response
​
id
string | null
required
Example:

"purchase.cf637646-71a4-430d-aaea-a66f1a48a83c"

​
offering_id
string | null
required

Which offering was purchased, if this purchase resulted from purchasing a pre-defined offering.

Example:

"offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9"

​
purchased_at
string | null
required

The time the purchase completed.

​
completed_at
string | null
required

The time the purchase completed.

Where Supertab requires a payment this will be null until the payment completes.

​
description
string
required
​
price
object
required

An amount of money

​
status
enum<string>
required

The status of the purchase.

Purchases may be pending or completed.

Only completed purchases grant access, pending purchases are purchases which require payment before entitlement is granted

Available options:
abandoned,
completed,
pending
​
metadata
object
required

Freeform metadata associated with the purchase.

This can be used for e.g associating the purchase with a user identifier in your system

​
entitlement_status
object | null
required

The customer's access (if any) as a result of this purchase