Skip to content
SendSignal Docs

Pagination

The two high-volume lists (GET /emails and GET /suppressions) use cursor pagination:

Terminal window
curl "https://api.sendsignal.dev/emails?limit=50" -H "Authorization: Bearer ss_..."
{
  "data": [ { "id": "…" }, … ],
  "next_cursor": "MjAyNi0wOC0…"
}
  • limit: page size. /emails defaults to 20, /suppressions to 50; values outside 1–100 fall back to the default.
  • cursor: pass the previous response’s next_cursor to get the next page. An empty next_cursor means you’ve reached the end.

Cursors encode a stable sort position (newest first), so pages don’t skip or duplicate rows when new items arrive mid-iteration. Treat the cursor as opaque.

Other list endpoints (domains, streams, templates, contacts, webhooks, …) return the full set as {"data": [...]} without a cursor.