Pagination

List endpoints take two query parameters:

Param	Default	Range
`page`	1	1+
`limit`	20	1–100

and return the same envelope:

{
  "items": [ ... ],
  "meta": {
    "totalItems": 57,
    "itemCount": 20,
    "itemsPerPage": 20,
    "totalPages": 3,
    "currentPage": 1
  }
}

Iterate until `totalPages`

A page can return fewer items than meta.itemsPerPage even when more pages exist. Loop until currentPage == totalPages; never stop at a short page.

const items = [];
let page = 1;
let totalPages = 1;
while (page <= totalPages) {
  const res = await fetch(`${API}/cards?page=${page}&limit=100`, {
    headers: { "x-api-key": KEY },
  }).then((r) => r.json());
  items.push(...res.items);
  totalPages = res.meta.totalPages;
  page++;
}

items = []
page, total_pages = 1, 1
while page <= total_pages:
    res = requests.get(
        f"{API}/cards", params={"page": page, "limit": 100},
        headers={"x-api-key": KEY},
    ).json()
    items += res["items"]
    total_pages = res["meta"]["totalPages"]
    page += 1

New items appear while you paginate, so expect minor overlap or shifts in live data.

Setup

Cards

Card account

Categories

Team members

Treasury

Health

Iterate until `totalPages`

​Iterate until totalPages

Iterate until `totalPages`