List Companies

GET

/companies

• Production
• QA

List companies with optional filtering and pagination.

Authorizations

• BearerAuth

Parameters

Query Parameters

page

Page number (1-indexed)

integer

default: 1 >= 1

Page number (1-indexed)

limit

Items per page (max 200)

integer

default: 50 >= 1 <= 200

Items per page (max 200)

domain

Any of:

string

string

null

null

Filter by domain (exact match)

industry

Any of:

string

string

null

null

Filter by industry (partial match)

name

Any of:

string

string

null

null

Filter by company name (partial match)

employee_count_min

Any of:

integer

integer

null

null

Minimum employee count

employee_count_max

Any of:

integer

integer

null

null

Maximum employee count

country

Any of:

string

string

null

null

Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK.

state

Any of:

string

string

null

null

Filter by state (exact match, case-insensitive; surrounding spaces ignored)

city

Any of:

string

string

null

null

Filter by city (partial match)

description

Any of:

string

string

null

null

Filter by company description (partial match)

revenue_min

Any of:

integer

integer

null

null

Minimum annual revenue

revenue_max

Any of:

integer

integer

null

null

Maximum annual revenue

founded_year_min

Any of:

integer

integer

>= 1800

null

null

Minimum founding year

founded_year_max

Any of:

integer

integer

<= 2100

null

null

Maximum founding year

linkedin_followers_min

Any of:

integer

integer

null

null

Minimum LinkedIn followers

linkedin_followers_max

Any of:

integer

integer

null

null

Maximum LinkedIn followers

include_custom_fields

When true, each company includes a custom_fields object of custom column values keyed by column slug. Default false keeps the legacy response shape and adds no extra query.

boolean

When true, each company includes a custom_fields object of custom column values keyed by column slug. Default false keeps the legacy response shape and adds no extra query.

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

Array<object>

Lighter company representation for list endpoints.

object

city

Any of:

string

string

null

null

country

Any of:

string

string

null

null

custom_fields

Any of:

object

object

key

additional properties

Any of:

string

string

null

null

null

null

description

Any of:

string

string

null

null

domain

Any of:

string

string

null

null

employee_count

Any of:

string

string

null

null

founded_year

Any of:

integer

integer

null

null

id

Any of:

integer

integer

null

null

industry

Any of:

string

string

null

null

linkedin_followers

Any of:

string

string

null

null

linkedin_url

Any of:

string

string

null

null

logo_url

Any of:

string

string

null

null

name

Any of:

string

string

null

null

owner_id

Any of:

string

string

null

null

owner_name

Any of:

string

string

null

null

revenue

Any of:

string

string

null

null

state

Any of:

string

string

null

null

website

Any of:

string

string

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string