PelekaPeleka Developers
API ReferenceAudienceContacts

List contacts, filtered by status, search, tag, segment, or source, cursor-paginated

GET
/api/v1/contacts
X-API-Key<token>

In: header

Query Parameters

status?string
search?string
tagId?string
segmentId?string
source?string
cursor?string
limit?string

Response Body

application/json

curl -X GET "https://example.com/api/v1/contacts"
{  "data": [    {      "id": "550e8400-e29b-41d4-a716-446655440000",      "workspaceId": "550e8400-e29b-41d4-a716-446655440000",      "email": "[email protected]",      "firstName": "Jane",      "lastName": "Doe",      "phone": "+14155550100",      "status": "subscribed",      "source": "import",      "customFields": {},      "createdAt": "2026-01-01T00:00:00.000Z",      "updatedAt": "2026-01-01T00:00:00.000Z"    }  ],  "nextCursor": null,  "total": 1}