APIPaymentsCustomer
Get all subscriptions for a customer
Retrieve a list of all subscriptions for a specific customer. This endpoint exposes legacy Finix subscription payload fields and is included for migration compatibility.
Authorization
apiKey x-easy-api-key<token>
Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.
In: header
Path Parameters
id*string
Length
1 <= lengthQuery Parameters
limit?number
Range
0 <= valueoffset?number
Range
0 <= valueids?string
status?string
Value in
"incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "unpaid" | "canceled" | "paused"Response Body
application/json
application/json
application/json
curl -X GET "https://loading/v1/api/customer/string/subscriptions"{
"success": true,
"timestamp": "2026-02-06T12:00:00.000Z",
"data": {
"data": [
{
"id": "SUxxxxxxxxxxxxxxxxxx",
"status": "active",
"identity_id": "IDxxxxxxxxxxxxxxxxxx",
"instrument_id": "PIxxxxxxxxxxxxxxxxxx",
"items": [
{
"id": "SIBxxxxxxxxxxxxxxxxxx",
"price_id": "pp_123456",
"quantity": 1,
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"price": {
"id": "pp_123456",
"unit_amount": 2999,
"currency": "USD",
"recurring": true,
"interval": "month",
"interval_count": 1,
"pricing_model": "per_unit",
"trial_period_days": null
}
}
],
"current_period_start": "2026-01-01T00:00:00.000Z",
"current_period_end": "2026-01-31T00:00:00.000Z",
"trial_start": null,
"trial_end": null,
"billing_cycle_anchor": "2026-01-01T00:00:00.000Z",
"cancel_at_period_end": false,
"cancel_at": null,
"canceled_at": null,
"pause_collection": null,
"latest_invoice_id": null,
"proration_behavior": "create_prorations",
"credit_balance": 0,
"pending_update": null,
"description": "Starter subscription",
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
},
"message": "Customers subscriptions fetched"
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}