Get Contact

Retrieve a single contact by its ID, including all associated fields, tags, custom fields, and attribution data.

GET/contacts/:contactId

Scope

contacts.readonly

Auth Method

Bearer Token

Token Type

Sub-Account / Company

Header Parameters

Parameter	Type	Description
`Authorization`required	string	Bearer {access_token}
`Version`required	string	API Version Possible values: `2021-07-28`

Path Parameters

Parameter	Type	Description
`contactId`required	string	The unique ID of the contact to retrieve.

Example RequestcURL

curl -X GET \
  'https://services.leadconnectorhq.com/contacts/{contactId}' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Version: 2021-07-28' \
  -H 'Accept: application/json'

Response — 200 OK

Example ResponseJSON

{
  "contact": {
    "id": "ocQHyuzHvuMOe5N5jjXF",
    "name": "John Doe",
    "locationId": "ve9EPM428h8vShlRW1KT",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "emailLowerCase": "[email protected]",
    "timezone": "America/Chicago",
    "companyName": "Acme Corp",
    "phone": "+1 555-123-4567",
    "dnd": false,
    "dndSettings": {
      "Call": { "status": "active", "message": "", "code": "" },
      "Email": { "status": "active", "message": "", "code": "" },
      "SMS": { "status": "active", "message": "", "code": "" },
      "WhatsApp": { "status": "active", "message": "", "code": "" },
      "GMB": { "status": "active", "message": "", "code": "" },
      "FB": { "status": "active", "message": "", "code": "" }
    },
    "type": "lead",
    "source": "api",
    "assignedTo": "user_abc123",
    "address1": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "country": "US",
    "postalCode": "78701",
    "website": "https://example.com",
    "tags": ["customer", "vip"],
    "dateOfBirth": "1990-01-15",
    "dateAdded": "2024-01-10T12:00:00.000Z",
    "dateUpdated": "2024-06-15T09:30:00.000Z",
    "customFields": [
      {
        "id": "cf_abc123",
        "value": "Enterprise"
      }
    ],
    "attributions": [
      {
        "url": "https://example.com/landing",
        "campaign": "spring_promo",
        "utmSource": "google",
        "utmMedium": "cpc",
        "sessionSource": "google"
      }
    ]
  }
}

DND Settings Note

The dndSettings object contains per-channel Do Not Disturb configuration. Each channel (Call, Email, SMS, WhatsApp, GMB, FB) has a status field with possible values: active, inactive, permanent.

← All Contacts endpoints Create Contact →