Pagination
List endpoints use limit/offset and tell you whether there is more.
List endpoints take two query parameters and return four pagination fields alongside the items.
| Parameter | Default | Range |
|---|---|---|
limit | 50 | 1–100. Values above 100 are rejected with 400. |
offset | 0 | 0 or more. |
curl "https://api.centerfy.ai/webhooks/inbound/contacts?limit=100&offset=200" \
-H "x-api-key: $CENTERFY_API_KEY"
{
"status": "success",
"total": 1284,
"limit": 100,
"offset": 200,
"has_more": true,
"contacts": [ "…" ]
}
Walk a whole collection by increasing offset by limit until has_more is false:
const all = [];
let offset = 0;
while (true) {
const page = await centerfy.contacts.list({ limit: 100, offset });
all.push(...page.contacts);
if (!page.has_more) break;
offset += page.limit;
}
A few endpoints use different limits or filters; their parameter tables say so.