Weav Docsv1

Guides / API basics

Pagination

List endpoints return results newest first, one page at a time, using a cursor.

Parameters

Field Type Description
per_page integer Results per page. Default 25. Values above 100 are lowered to 100.
cursor string The next_cursor or prev_cursor from the previous page. Send it back exactly as you got it.

The pagination object

JSON
"pagination": {
    "per_page": 25,
    "next_cursor": "eyJpZCI6MTM0LCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9",
    "prev_cursor": null,
    "is_last_page": false
}
  • A cursor is opaque. Never decode or build one.
  • A null cursor means there are no more pages in that direction.
  • There is no total count. Keep fetching until is_last_page is true.
  • An empty list returns 200 with an empty array, never 404.