JSON API Payload Patterns/Cursor-based response

Include a cursor token for the next page.

Section: Response envelopes

Cursor-based response

json
json
{
  "data": [
    { "id": "evt_1" },
    { "id": "evt_2" }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6ImV2dF8yIn0="
  }
}
Explanation

Cursor pagination scales better than offsets for some workloads.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Response envelopes
Single resource response
A simple object response with nested data.
OpenIn sheetjsonsame section
Paginated list response
A list payload with page metadata.
OpenIn sheetjsonsame section
Structured error payload
Return a machine-readable error code and human-readable message.
OpenIn sheetjson2 tag match
Partial update payload
Send only the fields that should change.
OpenIn sheetjson2 tag match
Event-style message payload
A message with event type, timestamp, and nested data.
OpenIn sheetjson1 tag match