List companies | AskElephant

Returns workspace companies using cursor pagination ordered by updated_at descending by default. filter[crm_associations][eq] supports only CRM objects with object_type=company.

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 company display names only. This does not search domains, descriptions, or CRM fields.

order_byenumOptional

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

Allowed values:

filter[domain][eq]stringOptional

Filter companies by exact domain after normalization.

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-Versionstring

Response

Paginated company list.

objectenum

Allowed values:

datalist of objects

has_moreboolean

next_cursorstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"object": "list",
3	"data": [
4	{
5	"object": "company",
6	"id": "cmp_9X4F7B2K",
7	"created_at": "2024-01-15T09:30:00Z",
8	"updated_at": "2024-04-20T16:45:00Z",
9	"name": "Acme Corporation",
10	"description": "Leading provider of innovative industrial solutions.",
11	"industry": "Manufacturing",
12	"website": "https://www.acmecorp.com",
13	"number_of_employees": 1200,
14	"logo_url": "https://www.acmecorp.com/assets/logo.png",
15	"crm_association": {
16	"object_type": "company",
17	"crm_object_id": "crm_789456123",
18	"source": "Salesforce"
19	},
20	"domains": [
21	{
22	"domain": "acmecorp.com"
23	}
24	]
25	}
26	],
27	"has_more": true,
28	"next_cursor": "eyJpZCI6ImNtcF85WDNGN0IySyJ9"
29	}

1	curl https://app.askelephant.ai/api/v2/companies \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"