Pagination
Page through gospace API collections with cursor or offset pagination.
Collection endpoints support cursor-based pagination with optional page/size parameters for initial fetches.
Query parameters
| Parameter | Type | Description |
|---|---|---|
page_size | integer | Number of items to return (default 50, max 500). |
page | integer | Optional offset-based page for the first request. |
cursor | string | Token returned in next_cursor or prev_cursor. Overrides page. |
sort | string | Sort expression such as created_at.desc (default) or updated_at.asc. |
Response envelope
{
"success": true,
"items": [ ... ],
"next_cursor": "eyJvZmZzZXQiOi...",
"prev_cursor": null,
"pagination": {
"total_results": 1203
}
}
next_cursorcontains an opaque token for the next page.prev_cursoris included when the API supports reverse traversal.pagination.total_resultsis available when the service can calculate a count cheaply; otherwise it is omitted.
Clients should store the cursor tokens verbatim and avoid parsing their contents.