Contacts
Search contacts
GET
List or search contacts (customers).
bearer contacts:readheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: contacts:read
search?stringName, email, phone or order number.
Length
length <= 200filter?stringDefault
"all"Value in
"all""with_email""without_email""flagged"groupId?stringContact group id. Never invent ids – list resources first.
Length
1 <= length <= 64limit?integerPage size, 1–100 (default 25).
Range
1 <= value <= 100Default
25cursor?stringCursor from the previous page's nextCursor. Omit for the first page.
Length
length <= 4000Success
application/json- response
data*array<>nextCursor*stringhasMore*booleancurl -X GET "https://example.com/contacts"{ "data": [ { "id": "string", "name": "string", "email": "string", "phone": "string", "orderNumber": "string", "location": { "city": "string", "country": "string" }, "language": "string", "visitCount": 0, "conversationCount": 0, "isFlagged": true, "lastSeenAt": 0, "lastActivityAt": 0, "createdAt": 0, "dashboardUrl": "string" } ], "nextCursor": "string", "hasMore": true}