Skip to main content
GET
/
v1
/
sdk
/
purchases
List purchases for provider
curl --request GET \
  --url https://api.example.com/v1/sdk/purchases
{
  "purchases": [
    {
      "amount": 9900,
      "createdAt": "<string>",
      "currency": "GBP",
      "customerEmail": "customer@example.com",
      "customerRef": "cus_3C4D5E6F",
      "isRecurring": true,
      "productRef": "prd_1A2B3C4D",
      "reference": "pur_1A2B3C4D",
      "startDate": "<string>",
      "status": "active",
      "autoRenew": true,
      "cancellationReason": "<string>",
      "cancelledAt": "<string>",
      "endDate": "<string>",
      "exchangeRate": 1.3082,
      "metadata": {},
      "nextBillingDate": "<string>",
      "originalAmount": 10000,
      "paidAt": "<string>",
      "planSnapshot": {
        "currency": "USD",
        "planType": "recurring",
        "price": 2999,
        "billingCycle": "monthly",
        "creditsPerUnit": 1,
        "features": {},
        "freeUnits": 100,
        "limit": 5000,
        "limits": {},
        "meterRef": "mtr_1A2B3C4D",
        "name": "Pro Monthly",
        "reference": "pln_1A2B3C4D"
      },
      "productName": "API Gateway Manager",
      "usage": {
        "overageCost": 0,
        "overageUnits": 0,
        "used": 150,
        "periodEnd": "2025-11-01T00:00:00Z",
        "periodStart": "2025-10-01T00:00:00Z"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.solvapay.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
status
enum<string>

Filter by purchase status

Available options:
pending,
active,
trialing,
past_due,
cancelled,
expired,
suspended,
refunded
​
productRef
string

Filter by product reference

​
customerRef
string

Filter by customer reference

Response

200 - application/json

Purchases retrieved successfully

​
purchases
object[]