Pagination & Cursors

The platform uses cursor pagination exclusively. Offset pagination is forbidden by AGENTS.md ?5.

Request

GET /api/v1/courses?cursor=eyJ2IjoxLCJrIjp7fX0&size=50 HTTP/1.1
Authorization: Bearer <jwt>
X-Tenant-Id: ten_01J?

• size is bounded ? hard cap 200.
• cursor is opaque base64url-encoded JSON { v: 1, k: { sortFields }, d: 'asc'|'desc', f: 'filterFingerprint' }. Treat it as opaque: never decode and edit in client code.

Response

{
  "data": [ /* items */ ],
  "meta": {
    "page": { "size": 50, "cursor": "eyJ2?", "nextCursor": "eyJ2?" }
  }
}

End of pagination is meta.page.nextCursor === null.