Page through list results

All list endpoints use page-number pagination via query parameters.

/api/v1/subscriptions/?page=2&page_size=50

Walking every page

next is a fully-formed URL, so paging is a loop that follows it until it comes back null:

GET /api/v1/subscriptions/?page_size=100
  → { "next": ".../subscriptions/?page=2&page_size=100", "results": [...] }
GET <next>
  → { "next": null, "results": [...] }        ← last page

Prefer following next over incrementing page yourself: it carries page_size and any other query parameters forward for you.

Response envelope

{
  "count": 150,
  "next": "https://be.suqo.ai/api/v1/subscriptions/?page=2",
  "previous": null,
  "results": [
    // Array of objects
  ]
}

The field shapes are in Object fields → Pagination envelope.

Some endpoints extend this envelope — Subscriptions adds status counts (total_subscriptions, active_subscriptions, and so on).