Pagination

List endpoints that can grow without bound use cursor pagination: you ask for a page, and the response tells you where the next one starts. Cursors are stable — new rows arriving while you page don't make you skip or repeat items, unlike offset pagination.

#How it works

1. Call the list endpoint with an optional limit.
2. The response includes nextCursor.
3. Pass it back as cursor on the next request.
4. Stop when nextCursor is null. (When the last page happens to be exactly full, you get one more request that returns an empty list and nextCursor: null.)

curl "https://api.ody.co/v1/api/contacts?limit=100" \
  -H "Authorization: Bearer $ODY_API_KEY"

# next page
curl "https://api.ody.co/v1/api/contacts?limit=100&cursor=eyJjIjoiMjAyNi0x…" \
  -H "Authorization: Bearer $ODY_API_KEY"

// The SDK follows nextCursor for you.
for await (const contact of ody.contacts.listAll({ limit: 200 })) {
  console.log(contact.id);
}

# The SDK follows nextCursor for you.
for contact in client.contacts.list_all(limit=200):
    print(contact["id"])

{
  "contacts": [{ "id": "8b1d…", "firstName": "Ada" }],
  "nextCursor": "eyJjIjoiMjAyNi0xMC0xNFQxODowMjoxMS4wMDBaIiwiaSI6IjhiMWQ…"
}

#Limits per endpoint