List contacts▾
List contacts
Page through everyone who has messaged you or been imported.
Contacts are created automatically the first time someone messages one of your numbers. You can also create them ahead of a broadcast.
GET
/v1/contactsQuery parameters
tagstringOnly contacts carrying this tag. Repeat for AND.
searchstringSubstring match on name or phone.
opted_inbooleanFilter by marketing opt-in state.
limitintegerdefault 25Page size, 1–100.
cursorstringFrom the previous page's next_cursor.
curl -X GET https://api.sendport.tech/v1/contacts \
-H "Authorization: Bearer $SENDPORT_KEY"Responses
200OK
{
"object": "list",
"data": [
{
"object": "contact",
"id": "ct_01JZQ7B2M4N8P0R2T4V6X8ZACE",
"wa_id": "201005550123",
"phone": "+201005550123",
"name": "Nadia Haddad",
"locale": "en",
"tags": ["vip", "cairo"],
"attributes": { "plan": "pro", "city": "Cairo" },
"opted_in": true,
"last_seen_at": "2026-09-06T08:41:02.000Z",
"created_at": "2026-05-14T08:12:44.000Z"
}
],
"has_more": false,
"next_cursor": null
}401Unauthorized
{
"error": {
"type": "authentication_error",
"code": "missing_api_key",
"message": "No API key provided.",
"doc_url": "https://sendport.tech/docs/errors#missing_api_key",
"request_id": "req_9f3c2a7b41de08c5b2e6"
}
}Try itsandbox