Pagination
How list endpoints split long results into pages, and how to read the next one.
List endpoints return one page at a time. Notix uses two styles: a cursor for lists that grow fast, like messages and logs, and a page number for lists you browse, like contacts and templates. Each endpoint page says which one it takes.
Cursor pagination
Pass limit for the page size. The response carries data and nextCursor. To get the next page, send nextCursor back as cursor. When nextCursor is null, you have the last page.
curl "https://app.usenotix.dev/api/v1/sms?limit=50" \
-H "Authorization: Bearer $NOTIX_API_KEY"
{
"data": [
{
"id": "sms_8f2k1",
"to": "+234*******5678",
"status": "delivered",
"segments": 1,
"charge": { "currency": "NGN", "amount": "8.00" },
"reason": null,
"createdAt": "2026-10-01T09:00:00.000Z",
"updatedAt": "2026-10-01T09:00:04.000Z"
}
],
"nextCursor": "cm9x2c4u10003ab7f"
}
curl "https://app.usenotix.dev/api/v1/sms?limit=50&cursor=cm9x2c4u10003ab7f" \
-H "Authorization: Bearer $NOTIX_API_KEY"
Keep the other filters the same while you page. A cursor is only meaningful for the list and filters that produced it.
| Endpoint | Default limit | Most per page |
|---|---|---|
| List SMS messages | 50 | 100 |
| List one-time codes | 50 | 100 |
| List received messages | 25 | 100 |
| List conversations | 30 | 100 |
| List a segment's contacts | 50 | 100 |
| List a broadcast's recipients | 50 | 100 |
| List an automation's runs | 50 | 100 |
| List webhook calls | 20 | 50 |
| Read the audit log | 50 | 100 |
| List wallet transactions | 20 | 100 |
| List receipts | 20 | 100 |
List a segment's contacts also returns total, the number of contacts in the segment.
Page number pagination
Pass page, starting at 1, and on most of these endpoints limit. The response shape differs a little between them.
| Endpoint | Query | Default size | Most per page | Response |
|---|---|---|---|---|
| List emails | page, limit | 50 | 50 | data, count (all matching emails) |
| List contacts | page, limit | 50 | 200 | An array of contacts |
| List templates | page, limit | 50 | 100 | An array of templates |
| List the starter library | page, limit | 20 | 60 | data, page, limit, total, hasMore |
| List suppressed addresses | page, limit | 50 | 100 | data, total, page, limit |
| List broadcasts | page | 30 | 30 | campaigns, totalPage |
| List the people in an automation | page | 25 | 25 | data, total, page, pageSize |
curl "https://app.usenotix.dev/api/v1/contactBooks/cb_7h2k9/contacts?page=2&limit=100" \
-H "Authorization: Bearer $NOTIX_API_KEY"
When a page comes back with fewer items than you asked for, or empty, you have the last page.
Page numbers stop at 10,000 on the email, contact, suppression and broadcast lists. The people in an automation stop at page 400, the newest 10,000 people. For more, page the automation's runs by cursor, or use Export an automation's people.
Lists without pages
These return every item in one response: domains, contact books, segments, automations, webhooks, invoices, and a conversation's notes.