Pagination is endpoint-specific. Do not assume one global pattern.

Callaro list endpoints are mixed: many operational resources are page-based, while selected high-volume surfaces can be cursor-based depending on the route.

Common patterns

Page-based list
Cursor-based list

curl "https://api.callaro.ai/api/v1/bulk_call_campaigns?page=1&per_page=25" \
  -H "X-Api-Key: $CALLARO_API_KEY"

const pageResponse = await fetch('https://api.callaro.ai/api/v1/bulk_call_campaigns?page=1&per_page=25', {
  headers: { 'X-Api-Key': process.env.CALLARO_API_KEY }
});
const pagePayload = await pageResponse.json();
console.log(pagePayload.meta?.page, pagePayload.meta?.pages, pagePayload.meta?.count);

curl "https://api.callaro.ai/api/v1/voice_sessions?cursor=eyJpZCI6OTAwMX0&page_size=50" \
  -H "X-Api-Key: $CALLARO_API_KEY"

const cursorResponse = await fetch('https://api.callaro.ai/api/v1/voice_sessions?cursor=eyJpZCI6OTAwMX0&page_size=50', {
  headers: { 'X-Api-Key': process.env.CALLARO_API_KEY }
});
const cursorPayload = await cursorResponse.json();
console.log(cursorPayload.data?.next_cursor, cursorPayload.data?.items?.length);

Safe sync rules

Read endpoint docs before coding

Confirm whether the endpoint expects page/per_page or cursor/page_size.

Persist traversal state

Store page or next_cursor after each successful page so jobs can resume safely.

Use stable filters

Keep filter and sort parameters identical during one traversal window.

Dedupe by primary ID in sink

At-least-once sync runners should upsert by record ID to tolerate retries.

Sorting and filters

Prefer server-supported sort fields only.
Avoid offset-like assumptions when using cursors.
Narrow large scans with updated_at windows where supported.

Cursor and page semantics are not interchangeable. If a route is cursor-based, page counters may be ignored or produce unstable traversal.

Overview

Resource Guides

Generated Endpoints

Pagination, Filtering, and Sorting

Common patterns

Safe sync rules

Sorting and filters

​Pagination is endpoint-specific. Do not assume one global pattern.

​Common patterns

​Safe sync rules

​Sorting and filters

Pagination is endpoint-specific. Do not assume one global pattern.

Common patterns

Safe sync rules

Sorting and filters