Purchases
Get purchases for a customer
Retrieves all purchases for a specific customer. Useful for billing history and access checks.
get/v1/sdk/purchases/customer/{customerRef}
Path parameters
customerRefstring required
Example:cus_3C4D5E6F
Customer reference or ID
Query parameters
includeFreeboolean
Include free auto-enrollments (default true for customer-scoped views)
Response
Customer purchases retrieved successfully
Example response
{
"purchases": [
{
"amount": 9900,
"currency": "GBP",
"customerEmail": "customer@example.com",
"customerRef": "cus_3C4D5E6F",
"exchangeRate": 1.3082,
"isRecurring": true,
"originalAmount": 10000,
"planSnapshot": {
"billingCycle": "monthly",
"creditsPerUnit": 1,
"currency": "USD",
"freeUnits": 100,
"limit": 5000,
"meterRef": "mtr_1A2B3C4D",
"name": "Pro Monthly",
"planType": "recurring",
"price": 2999,
"reference": "pln_1A2B3C4D"
},
"productName": "API Gateway Manager",
"productRef": "prd_1A2B3C4D",
"reference": "pur_1A2B3C4D",
"status": "active",
"usage": {
"periodEnd": "2025-11-01T00:00:00Z",
"periodStart": "2025-10-01T00:00:00Z",
"used": 150
}
}
]
}