Get a purchase by reference
Retrieves a single purchase including plan snapshot, usage, and billing details.
Authorizations
Provider secret API key (sk_live_… / sk_test_…) supplied as a Bearer token.
Path Parameters
Purchase reference or ID
"pur_1A2B3C4D"
Response
Purchase retrieved successfully
Amount in USD cents (normalised for aggregation)
9900
Created at
ISO 4217 currency code of the customer-facing charge
"GBP"
Customer reference
"cus_3C4D5E6F"
Whether the purchase is recurring
true
Purchase reference
"pur_1A2B3C4D"
Start date
"2025-10-27T10:00:00Z"
Purchase status
"active"
Auto-renew enabled
Billing cycle
weekly, monthly, quarterly, yearly Reason for cancellation
"Customer request"
When purchase was cancelled
"2025-10-28T10:00:00Z"
Customer email
"customer@example.com"
End date of purchase
"2025-11-27T10:00:00Z"
Exchange rate from original currency to USD
1.32
Arbitrary metadata attached to the purchase
Next billing date
How the purchase originated
paid, free_default, manual, one_time, credit_topup, admin_assignment "paid"
Original amount in the payment currency (minor units)
7500
Paid at timestamp
Plan reference from the plan snapshot, for reliable plan matching
"pln_abc123"
Snapshot of the plan at time of purchase
Product name
"API Gateway Manager"
Product reference
"prd_abc123"
Whether the purchase requires payment
false
Billing period of the active usage window; counts come from /v1/sdk/limits