List Contacts

List the authenticated user's CRM contacts with search, filtering, and pagination. Requires an OAuth access token with 'contacts' scope.

GET/v1/contacts

Authentication

OAuthAuthorization: Bearer

Requires OAuth access token (scope: contacts)

Query Parameters

querystring

optional

Search by name, email, or phone

pagenumber

optional

Page number (default: 1)

limitnumber

optional

Results per page (max 50, default: 25)

sinceISO 8601

optional

Contacts created/updated after this time

stagestring

optional

Filter by pipeline stage

tagstring

optional

Filter by tag

Sortenum

optional

Sort field

Default:createdAt

createdAtlastActivityDatename

Orderenum

optional

Sort order

Default:desc

descasc

Responses

200Success

application/json

totalnumber

Total matching contacts

pagenumber

Current page number

limitnumber

Results per page

contactsarray

Array of contact objects

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/contacts?query=Maria&Sort=lastActivityDate&limit=10" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response200 OK

{
  "total": 47,
  "page": 1,
  "limit": 25,
  "contacts": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Maria Garcia",
      "email": "maria@example.com",
      "phones": [
        "+1234567890"
      ],
      "stage": "Active",
      "source": "Website",
      "tags": [
        "buyer",
        "waterfront"
      ],
      "type": "buyer",
      "price": 500000,
      "isRegistered": true,
      "totalNotes": 3,
      "totalDocuments": 1,
      "totalSavedSearches": 2,
      "createdAt": "2026-01-15T10:30:00Z",
      "lastActivityDate": "2026-03-17T14:30:00Z"
    }
  ]
}