Subscriptions Admin API

List the subscriptions

GET /api/v1/subscriptions

The subscriptions of the customers the token's admin may read, a page at a time, each as stored, column by column, with the paging of the list around them.

Parameters
page integer query
Default: 1
per_page integer query
Subscriptions per page.
Default: 25
Responses
200 One page of subscriptions.
401 The token is missing or wrong (Unauthenticated.), or its user may not act on this object (Unauthorized). Without the Accept: application/json header, a missing or wrong token answers with a redirect to the sign-in page instead.
List the subscriptions
1 2 3
curl 'https://your-domain/api/v1/subscriptions' \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
1 2
$client = new Acelle\Client('https://your-domain/api/v1', 'YOUR_API_TOKEN');
$client->subscription()->all(['page' => 1, 'per_page' => 25]);
Response
{
    "current_page": 1,
    "last_page": 22,
    "per_page": 1,
    "total": 22,
    "data": [
        {
            "id": 1,
            "uid": "6adaabbcdbd1e",
            "customer_id": 1,
            "plan_id": 3,
            "status": "active",
            "current_period_ends_at": "2027-10-23T00:35:08.000000Z",
            "trial_ends_at": null,
            "cancelled_at": null,
            "terminated_at": null,
            "created_at": "2026-10-23T00:35:08.000000Z",
            "updated_at": "2026-10-23T00:35:08.000000Z"
        }
    ]
}