Turgo AI

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 automates revenue operations for B2B companies. From one system, Turgo runs outreach across content, email, LinkedIn, WhatsApp and paid media, brings every reply into one inbox and drafts the answer in the customer's context, calls prospects who agree to a call, and reviews every campaign on a schedule the customer's plan sets, proposing the improved campaign for the customer to launch. Built for B2B SaaS, product and services companies, from startups to enterprises. Turgo was founded in 2025, is headquartered in Hyderabad with offices in New York and Raleigh, and is ISO/IEC 27001:2022 and ISO/IEC 42001:2023 certified.

Turgo AI
Ready to automate RevOps?