Public APIContacts
List contacts (paginated)
Authorization
bearerAuth AuthorizationBearer <token>
API key in the Authorization: Bearer <key> header.
Keys are created in the SMAO dashboard (Settings → API Keys).
In: header
Query Parameters
cursor?string
Opaque cursor from a prior meta.next_cursor. Base64url-encoded
(unpadded) — do not parse or construct it manually.
Match
^[A-Za-z0-9_-]+$limit?integer
Items per page (1–200, default 50).
Range
1 <= value <= 200Default
50group_id?string
Filter by contacts group.
Match
^[a-f0-9]{24}$Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/contacts"{ "data": [ { "id": "string", "group_id": "string", "group_name": "string", "phone_numbers": [ "string" ], "first_name": "string", "last_name": "string", "email": "string", "company": "string", "gender": "string", "prompt": "string", "preferred_language": "string", "forwarding_id": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "meta": { "has_more": true, "next_cursor": "string" }}