Skip to main content
GET
Get Many Companies
This endpoint uses the Company object.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

idsOrDomains
string

Comma-separated list of company IDs or domains to fetch. When provided, returns only matching companies (no pagination). Each value is classified as a company ID (e.g. cpn_xxx) or a domain (e.g. example.com). URLs are normalized automatically (e.g. https://example.com/pathexample.com). Invalid values are silently skipped. Maximum 100 values.

page
integer

Page number to retrieve. Ignored when idsOrDomains is provided.

sortBy
enum<string>

The field by which to sort. Currently, only 'createdAt' is supported.

Available options:
createdAt
sortOrder
enum<string>

The sort direction. Use 'desc' for descending order; any other value (or omission) will sort in ascending order.

Available options:
asc,
desc

Search by company name (case insensitive)

fields
string

Returns selected fields. Returns all fields if empty. Each field is separated by a comma (e.g., '_id,fields.name,domain')

limit
integer

Number of companies to retrieve. Default: 100. Maximum: 100

Response

Success

data
object[]
required
total
integer
required