List pagination¶

Catalog lists (features, plans), entitlements, check, overrides, members, and keys return the full collection.

Query¶

Param
`limit`	Optional. Default 50, max 100. Over-max is clamped, not 422. `< 1` or non-integer → 422 `VALIDATION_ERROR`.
`starting_after`	Optional. Exclusive cursor: the `id` of the last item on the previous page. Omit on the first page.

Pagination is cursor-based (starting_after), not page numbers.

starting_after must be a well-formed id for that collection. Invalid → 422 VALIDATION_ERROR. A well-formed id that is not in the collection is not an error — the walk continues after that point in id order.

Order¶

Paginated lists are id ascending, except the audit log, which is newest first. Full-collection lists (features, plans, overrides) are newest first.

Subscriber id is the id you chose (lexicographic). Subscription id is a ULID (time-sortable).

Body¶

{
  "subscribers": [ ... ],
  "has_more": false
}

Field
named collection	Plural resource key (`subscribers`, `subscriptions`).
`has_more`	`true` if another page exists. Always present.

When has_more is true, pass the last item’s id as starting_after on the following request. Do not send starting_after when has_more is false.

No total. limit is not echoed.

Paginated lists¶

GET …/subscribers
GET …/subscribers/{subscriber_id}/subscriptions
GET …/audit-events (newest first)