LeadCeleris
LeadCeleris developer platform

Contacts API reference

Read organization contacts with cursor pagination, lead status, source, and activity timestamps.

Reading time

6 min

Sections

3 implementation topics
01

List contacts

Send GET /api/v1/contacts with a valid Bearer API key. The endpoint returns active, unblocked contacts associated with connected WhatsApp instances in the authenticated organization.

02

Paginate with limit and cursor

The default limit is 50 and the maximum is 200. Pass the next_cursor value from one response as the cursor query parameter on the next request.

The response contains success, data, and next_cursor. A null next_cursor means there is no additional page.

03

Contact fields

Each contact includes id, name, phone, tag, leadLevel, source, lastSeen, createdAt, and updatedAt. Treat IDs and enum-like values as opaque unless the documentation explicitly defines them.