Pagination

How to page through lists.

List endpoints (like generations, scenes, and Discover) return results in pages.

How it works

Each response has a meta block:

{
  "data": [ ... ],
  "meta": {
    "has_more": true,
    "cursor": "eyJ2IjoyLCJjcmVhdGVkX2F0..."
  }
}

To get the next page, pass that cursor back:

curl "https://api.roasos.com/v1/generations?limit=20&cursor=CURSOR_FROM_LAST_RESPONSE" \
  -H "Authorization: Bearer roasos_sk_..."

When has_more is false, you’ve reached the end.

Options

• limit — how many items per page (1–100, default 20).
• cursor — the value from the previous response’s meta.cursor.