Get Contact Details

Contact details with address, links, and custom fields. Use the Scope parameter to include extra data like notes, collections, and saved searches (runs additional queries in parallel).

GET/v1/contacts/:contactId

Authentication

OAuthAuthorization: Bearer

Requires OAuth access token (scope: contacts)

Query Parameters

contactIdstring

required

Contact ID (URL path parameter)

scopestring

optional

Comma-separated extra data to include. Default: none (lightweight response)

notescollectionssavedSearches

Responses

200Success

application/json

idstring

Contact ID

namestring

Contact full name

emailstring

Contact email

phonesarray

Phone numbers

stagestring

Pipeline stage

sourcestring

Lead source

tagsarray

Contact tags

typestring

Contact type (buyer, seller, etc.)

pricenumber

Budget or target price

birthdaystring

ISO 8601 birth date

isRegisteredboolean

Whether the contact has a registered account

addressobject

Structured address: formatted, locality, stateShort, postalCode, etc.

streetAddressstring

Street address string

linksobject

Social links: website, linkedin, facebook, instagram, twitter, youtube

spokenLanguagesarray

Languages the contact speaks

additionalarray

Custom fields: [{ name, value }]

notesarray

Contact notes: [{ id, content, pinned, createdAt }]

savedSearchesarray

Saved property searches: [{ id, name }]

totalNotesnumber

Total notes count

totalDocumentsnumber

Total documents count

totalSavedSearchesnumber

Total saved searches count

createdAtstring

ISO 8601 creation date

lastActivityDatestring

ISO 8601 date of last activity

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/contacts/507f1f77bcf86cd799439011" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response200 OK

{
  "id": "507f1f77bcf86cd799439011",
  "name": "Maria Garcia",
  "email": "maria@example.com",
  "phones": [
    "+1234567890"
  ],
  "stage": "Active",
  "source": "Website",
  "tags": [
    "buyer",
    "waterfront"
  ],
  "type": "buyer",
  "price": 500000,
  "birthday": "1990-05-15T00:00:00Z",
  "isRegistered": true,
  "address": {
    "formatted": "1010 Brickell Ave, Miami, FL 33131",
    "locality": "Miami",
    "stateShort": "FL",
    "postalCode": "33131"
  },
  "links": {
    "instagram": "...",
    "linkedin": "..."
  },
  "spokenLanguages": [
    "English",
    "Spanish"
  ],
  "additional": [
    {
      "name": "Company",
      "value": "Acme Corp"
    }
  ],
  ...
}