curl --request GET \
--url https://api.kelviq.com/api/v1/subscriptions/ \
--header 'Authorization: Bearer <token>'{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": "09d706ca-58f3-4fb2-818f-5b8623d67e6e",
"externalSubscriptionId": "sub_1RpoZoSBstCzyocS7iPmith3",
"startDate": "2025-07-28",
"endDate": null,
"billingPeriodStartTime": "2025-07-28T10:46:34Z",
"billingPeriodEndTime": "2025-08-28T10:46:34Z",
"amount": "261.00",
"recurrence": "month",
"currency": "usd",
"status": "active",
"product": "Aphelo",
"plan": {
"name": "Premium",
"identifier": "premium1"
},
"features": [
{
"id": "b417ae2f-35e2-48f2-a5c4-fdaa99b2b96a",
"identifier": "products",
"name": "Products",
"description": "",
"featureType": "CUSTOMIZABLE",
"details": {},
"isArchived": false,
"metadata": {},
"modifiedOn": "2025-06-14T11:36:26.062491Z",
"meter": {},
"featureDetails": {
"units": {
"plural": "counts",
"singular": "count"
}
},
"reset": null,
"resetTime": null,
"value": 100,
"hardLimit": false
}
],
"trialDaysRemaining": 0,
"customerId": "testuser"
}
]
}Retrieves a paginated list of subscriptions. You can filter the results by customer.
curl --request GET \
--url https://api.kelviq.com/api/v1/subscriptions/ \
--header 'Authorization: Bearer <token>'{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": "09d706ca-58f3-4fb2-818f-5b8623d67e6e",
"externalSubscriptionId": "sub_1RpoZoSBstCzyocS7iPmith3",
"startDate": "2025-07-28",
"endDate": null,
"billingPeriodStartTime": "2025-07-28T10:46:34Z",
"billingPeriodEndTime": "2025-08-28T10:46:34Z",
"amount": "261.00",
"recurrence": "month",
"currency": "usd",
"status": "active",
"product": "Aphelo",
"plan": {
"name": "Premium",
"identifier": "premium1"
},
"features": [
{
"id": "b417ae2f-35e2-48f2-a5c4-fdaa99b2b96a",
"identifier": "products",
"name": "Products",
"description": "",
"featureType": "CUSTOMIZABLE",
"details": {},
"isArchived": false,
"metadata": {},
"modifiedOn": "2025-06-14T11:36:26.062491Z",
"meter": {},
"featureDetails": {
"units": {
"plural": "counts",
"singular": "count"
}
},
"reset": null,
"resetTime": null,
"value": 100,
"hardLimit": false
}
],
"trialDaysRemaining": 0,
"customerId": "testuser"
}
]
}The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'
The client-defined unique identifier for the customer to filter subscriptions.
Number of results to return per page.
The initial index from which to return the results.