Get all contacts

GET

/users/me/contacts

Paginated list of non-deleted contacts with per-contact stats (call counts, last interaction date) and aggregations (unique company count + list). sort accepts lastInteraction, created, or name — invalid values silently fall back to created. Sorting by lastInteraction is indexed but can get slow above ~10k contacts; prefer created for the default list view.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/users/me/contacts?limit=&offset=&sort=' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "contacts": [
        {
            "firstName": "string",
            "lastName": "string",
            "phoneNumber": "string",
            "email": "string",
            "address": "string",
            "notes": "string",
            "companyName": "string",
            "tags": [
                "string"
            ],
            "avatar": "string",
            "isFavorite": true,
            "source": "MOBILE",
            "lifecycleStage": "lead",
            "doNotCall": true,
            "doNotSms": true,
            "id": "string",
            "stats": {
                "totalIncomingCalls": 0,
                "totalOutboundCalls": 0,
                "totalSmsMessages": 0,
                "lastCallDate": "string",
                "upcomingAppointments": 0
            },
            "latestNote": {
                "content": "string",
                "createdAt": "string"
            },
            "suggestedLifecycleStage": "string"
        }
    ],
    "pagination": {
        "total": 0,
        "limit": 0,
        "offset": 0
    },
    "aggregations": {
        "uniqueCompanies": 0,
        "companies": [
            "string"
        ]
    }
}

Modified at 2026-07-23 18:02:16

Delete all contacts

Update contact