Pagination - Sendbaze

List endpoints that can grow without bound (GET /v1/emails, GET /v1/suppressions, GET /v1/webhooks/{id}/deliveries) are cursor-paged. Short lists (GET /v1/domains, GET /v1/templates, GET /v1/webhooks) return everything under data.

Request

Parameter	Meaning
`limit`	Rows per page. Emails: 1 to 100, default 50. Suppressions and deliveries: 1 to 200, default 50.
`cursor`	The `nextCursor` from the previous response. Omit for the first page.

Response

{
  "data": [ { "id": "em_01j9...", "...": "..." } ],
  "nextCursor": "MjAyNi0xMC0yN1QwOToxMjo0MS4wMDBafGVtXzAxajl4..."
}

nextCursor is null on the last page. Cursors are opaque; do not build or edit them. A cursor the API did not issue is 422 validation_error.

Walking every page

let cursor: string | undefined;
do {
  const page = await sendbaze.emails.list({ status: "bounced", limit: 100, cursor });
  for (const email of page.data) console.log(email.id, email.to);
  cursor = page.nextCursor ?? undefined;
} while (cursor);

cursor = None
while True:
    params = {"status": "bounced", "limit": 100}
    if cursor:
        params["cursor"] = cursor
    page = requests.get("https://api.sendbaze.com/v1/emails", headers=headers, params=params).json()
    for email in page["data"]:
        print(email["id"], email["to"])
    cursor = page["nextCursor"]
    if not cursor:
        break

Pages are ordered by creation time, newest first, and keyed on (createdAt, id), so rows that arrive while you paginate never shift the ones you have already seen.