← Contacts

Get Contacts By Business ID

Retrieve all contacts associated with a specific business entity.

GET/contacts/business/:businessId
Scope
contacts.readonly
Auth Method
Bearer Token
Token Type
Sub-Account / Company

Header Parameters

ParameterTypeDescription
AuthorizationrequiredstringBearer {access_token}
VersionrequiredstringAPI Version
Possible values: 2021-07-28

Path Parameters

ParameterTypeDescription
businessIdrequiredstringThe unique ID of the business to retrieve contacts for.

Query Parameters

ParameterTypeDescription
locationIdrequiredstringSub-account ID.
limitintegerNumber of contacts per page. Default: 20, Max: 100.
skipintegerNumber of contacts to skip (offset pagination).
Example RequestcURL
curl -X GET \
  'https://services.leadconnectorhq.com/contacts/business/{businessId}?locationId=ve9EPM428h8vShlRW1KT&limit=20' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Version: 2021-07-28' \
  -H 'Accept: application/json'

Response — 200 OK

Example ResponseJSON
{
  "contacts": [
    {
      "id": "ocQHyuzHvuMOe5N5jjXF",
      "name": "John Doe",
      "email": "[email protected]",
      "phone": "+15551234567",
      "locationId": "ve9EPM428h8vShlRW1KT",
      "companyName": "Acme Corp",
      "tags": ["customer"],
      "dateAdded": "2024-01-10T12:00:00.000Z"
    }
  ],
  "total": 1
}