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.

ParameterDefaultRange
limit501–100. Values above 100 are rejected with 400.
offset00 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.

© 2026 Centerfy AI. All rights reserved.