List endpoints in API v2 use cursor-based pagination with a consistent shape:
{
"data": [ ... ],
"meta": {
"nextCursor": "cursor_value_or_null",
"hasMore": true
}
}
Query parameters
| Parameter | Type | Default | Description |
|---|
cursor | string | none | Cursor from the previous response (meta.nextCursor) |
pageSize | number | 30 | Items per page (max 100) |
API v2 uses pageSize. Legacy v1 list endpoints use limit instead.
Example
curl "https://api.heffl.com/api/v2/contacts?pageSize=25" \
-H "x-api-key: YOUR_API_KEY"
{
"data": [
{
"id": "clt_abc123",
"number": "CON001",
"firstName": "Jane",
"lastName": "Smith",
"email": "[email protected]"
}
],
"meta": {
"nextCursor": null,
"hasMore": false
}
}
