List contacts | AskElephant | API Documentation

{
  "object": "list",
  "data": [
    {
      "object": "contact",
      "id": "cnt_01HQY3JMS2QAXJGX6X7CH7CM6X",
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-04T18:25:00Z",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "description": "Primary customer contact for analytical projects.",
      "company": {
        "id": "cmp_01HQXVB4Y9Y0Q6P0QH5GX2CT7T",
        "object": "company"
      },
      "emails": [
        {
          "email": "ada@analytical.engine",
          "is_primary": true
        }
      ],
      "phone_numbers": [
        {
          "phone_number": "+1-555-0100",
          "is_primary": true
        }
      ],
      "time_zone": "America/Los_Angeles"
    }
  ],
  "has_more": false,
  "next_cursor": "eyJpZCI6ImNudF8wMUhRWTNKTVMyUUFYSkdYNlg3Q0g3Q002WCJ9"
}

Returns workspace contacts using cursor pagination ordered by updated_at descending by default. filter[crm_associations][eq] supports only CRM objects with object_type=contact. This endpoint accepts limit, cursor, search, order_by, filter[crm_associations], and filter[updated_at] only; expand and legacy top-level aliases are not supported. Requires the contacts:read scope.

Returns workspace contacts using cursor pagination ordered by `updated_at` descending by default. `filter[crm_associations][eq]` supports only CRM objects with `object_type=contact`. This endpoint accepts `limit`, `cursor`, `search`, `order_by`, `filter[crm_associations]`, and `filter[updated_at]` only; `expand` and legacy top-level aliases are not supported. Requires the `contacts:read` scope.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

limitintegerOptional1-100Defaults to 25

Maximum number of results to return. Defaults to 25 and is capped at 100.

cursorstringOptional

Opaque cursor from a previous list response.

searchstringOptional

Free-text search string matched against contact full names and email addresses. This does not search phone numbers, descriptions, or company data.

order_byenumOptional

Sort order for the list. Defaults to updated_at:desc.

Allowed values:

filter[crm_associations][eq]stringOptional

Filter resources by CRM associations. For readability, docs examples use indexed bracket syntax such as filter[crm_associations][eq][0][id]=123 plus filter[crm_associations][eq][0][object_type]=<supported-object-type>. The API also accepts a JSON-encoded array string with objects containing id and object_type. CRM source is inferred from the workspace’s connected CRM state. Supported object_type values depend on the endpoint. Supports up to 20 objects.

Filter resources by CRM associations. For readability, docs examples use indexed bracket syntax such as `filter[crm_associations][eq][0][id]=123` plus `filter[crm_associations][eq][0][object_type]=<supported-object-type>`. The API also accepts a JSON-encoded array string with objects containing `id` and `object_type`. CRM source is inferred from the workspace's connected CRM state. Supported `object_type` values depend on the endpoint. Supports up to 20 objects.

filter[updated_at][gt]datetimeOptional

Return resources updated strictly after the provided ISO-8601 UTC timestamp.

filter[updated_at][gte]datetimeOptional

Return resources updated at or after the provided ISO-8601 UTC timestamp.

filter[updated_at][lt]datetimeOptional

Return resources updated strictly before the provided ISO-8601 UTC timestamp.

filter[updated_at][lte]datetimeOptional

Return resources updated at or before the provided ISO-8601 UTC timestamp.

Response headers

X-Api-VersionstringOptional

Response

Paginated contacts list.

objectenum

Resource discriminator for list responses.

datalist of objects

Contact records in the current page.

has_moreboolean

Indicates whether another page of contacts is available.

next_cursorstring or null

Opaque cursor for the next page, or null when there are no more results.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

$	curl https://app.askelephant.ai/api/v2/contacts \
>	-H "Authorization: Bearer <token>"