Allo

Search companies

Search and filter companies in your CRM.

POST/v2/api/crm/companies/search

This endpoint is paginated. Use page and size in the request body to control results. See Pagination.

Request body

FieldTypeDescription
filtersobjectNamed filters (see below)
sortstringSort order: DATE_DESC, DATE_ASC, NAME_ASC, NAME_DESC, CREATED_DESC, CREATED_ASC
pageintegerPage number (1-indexed)
sizeintegerResults per page (max 100)

Filters

Pass an object with named fields. All provided filters are combined with AND.

{
  "filters": {
    "name": "Acme",
    "industry": "Technology"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}

Available filter fields

FieldMatch typeDescription
namecontainsCompany name
websitecontainsWebsite URL
industrycontainsIndustry sector

Custom attributes

Each result includes custom_attributes, the values of your company attributes keyed by attribute key. Always present, {} when there are none, with the same formats as Get company. Custom attributes cannot be used to filter or sort.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Body

filtersobject | null

Named filters. All are combined with AND.

3 fields
namestring

Filter by company name (contains)

websitestring

Filter by website (contains)

industrystring

Filter by industry (contains)

sortenum<string>

Sort order (default: DATE_DESC)

DATE_DESCDATE_ASCNAME_ASCNAME_DESCCREATED_DESCCREATED_ASC

pageinteger

Page number (1-indexed)

sizeinteger

Results per page

Responses

200Search results
dataobject[]
11 fields
idstring

Unique company identifier

namestring

Company name

websitestring | null

Company website URL

industrystring | null

Industry sector

numbersstring[]

Phone numbers of the company, in E.164 format

person_countinteger

Number of people linked to this company

interactionsinteger

Total number of interactions across all people in this company

last_activity_atstring<date-time> | null

Timestamp of the last activity

created_atstring<date-time>

When the company was created

updated_atstring<date-time>

When the company was last updated

custom_attributesobject

Values of the company's custom attributes, keyed by attribute key. Always present, {} when there are none. Archived attributes and empty values are omitted. NUMBER values are decimals (180 is returned as 180.0), DATE values are YYYY-MM-DD and DROPDOWN values are the option key. Create the attributes first with POST /v2/api/crm/companies/attributes.

paginationobject
5 fields
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
401
422
429