Pagination

List endpoints return a stable, cursor-paginated envelope.

The list envelope

Every list response shares one shape: has_more, an items array, and a next_cursor.

200 · application/json

{
  "has_more": true,
  "next_cursor": "cursor_8Ttz1Le9",
  "items": [
    { "id": "fld_3nZq7Kp2", "name": "North Quarter" }
  ]
}

Parameters

Parameter	Description
`limit`	Page size, 1–100. Defaults to 50.
`cursor`	The `next_cursor` from the previous page.

Walking every page

python

def all_items(session, url):
    cursor, out = None, []
    while True:
        params = {"limit": 100}
        if cursor:
            params["cursor"] = cursor
        page = session.get(url, params=params).json()
        out.extend(page["items"])
        if not page["has_more"]:
            return out
        cursor = page["next_cursor"]

Treat next_cursor as opaque. Stop when has_more is false.