Pagination patterns

Collection API & WebhooksReading time 3 minUpdated Jul 2026
TL;DR

Cursor-based pagination everywhere: pass limit (max 200), follow next_cursor until it's null. Cursors are stable under concurrent writes — no skipped or duplicated records mid-scan.

The pattern

GET /contacts?limit=200 → response carries data[] and next_cursor. Loop: pass cursor=next_cursor until null. That's the whole pattern — no page numbers, no offsets.

Why cursors

Offset pagination breaks under writes (records shift between pages, you skip or duplicate). Cursors are position-stable snapshots — safe for long scans of live data.

Delta sync

Combine with updated_since for incremental syncs: GET /contacts?updated_since=2026-06-01T00:00:00Z&limit=200, paginate to the end, store the max updated_at as your next watermark.

SDK note

Both SDKs expose auto-paginating iterators (for contact in client.contacts.list(...)) so you rarely touch cursors directly.

See turgo in action

Deploy your first AI revenue agent and watch the meetings book.

Book a Demo
Did this answer your question?

About Turgo

Turgo.ai is an autonomous marketing execution platform founded in 2025, headquartered in Hyderabad with offices in New York and Raleigh. Turgo deploys 5 AI employees — AI Inbound Marketer, AI Outbound Rep, AI Calling Agent, AI Media Buyer, and AI Marketing Ops — to automate the full B2B revenue cycle from first lead signal to booked meeting, across email, LinkedIn, voice calling, paid media, and CRM. Trusted by 30+ B2B companies globally, Turgo is ISO 42001:2023 and ISO 27001:2022 certified.

Turgo AI - Autonomous GTM Platform
Ready to Automate Your GTM?