Get all contacts

GET

/contacts

Returns a paginated list of contacts. This endpoint is optimized for UI listing and quick fulltext search.

Note: limit is capped server-side at 10,000 regardless of the value requested (a limit=100000 request silently returns only 10,000 items, not an error) — page with offset to fetch more. Pagination uses plain SQL OFFSET, not a cursor, so per-page latency grows as offset increases on large contact lists; clients pulling a full large list should expect later pages to take longer, not assume flat per-page latency.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/contacts?q=John&limit=20&offset=0' \
--header 'Authorization: Bearer JWT'

Response Example

{
    "contacts": [
        {
            "contactId": "string",
            "clientContactId": "string",
            "firstName": "string",
            "lastName": "string",
            "titleBefore": "string",
            "titleAfter": "string",
            "formalSalutation": "string",
            "informalSalutation": "string",
            "company": "string",
            "position": "string",
            "personalId": "string",
            "consentDate": "string",
            "contactSource": "string",
            "created": "string",
            "updated": "string",
            "email": "string",
            "bounced": "HARD",
            "phoneNumber1": "string",
            "city": "string",
            "country": "string",
            "tags": [
                "string"
            ],
            "fields": [
                {
                    "name": "string",
                    "value": "string",
                    "group": "string"
                }
            ],
            "lists": [
                "string"
            ],
            "listIds": [
                0
            ]
        }
    ],
    "paging": {
        "total": 0,
        "limit": 0,
        "offset": 0
    }
}

Modified at 2026-08-01 17:57:32

Get contact events by email

Create contact