BaseloopDocs

Pagination

Page through rows with a cursor.

Row endpoints return one page at a time, up to limit rows (100 by default and at most). Each page tells you whether there is another:

{
  "rows": [],
  "limit": 100,
  "nextCursor": "eyJ0eXBlIjoiY3JlYXRlZEF0RGVzYyIsLi4ufQ",
  "hasNextPage": true
}

To get the next page, send the same request again with nextCursor as cursor:

curl "https://api-v2.baseloop.io/v1/tables/<tableId>/rows?limit=100&cursor=<nextCursor>" \
  -H "Authorization: Bearer <api-key>"

For POST /rows/query, put cursor in the body. Keep going until hasNextPage is false; on the last page nextCursor is null.

Rules for cursors

  • Treat a cursor as an opaque string. Do not read, build or change it.
  • Use a cursor only with the endpoint, search and filters that produced it. A cursor reused with a different search or filters returns 400.
  • Responses have no total count. To know how many rows a table has, use rowCount from GET /tables.

Order

  • Without search text or filter rules, both row endpoints return rows newest first.
  • With search text or filter rules, they return rows in a stable order by row ID.

Custom sorting is not supported.

On this page