Skip to main content
POST
cURL
Company search accepts every company and people filter. With people filters, it returns companies where one person matches all of them together. See Filters for the filters and the forms their codes take. Each record carries one object per market searched, keyed by the lowercase market code. With people filters, a page can return one record fewer than page.size. total stays correct. Codes such as "revenue": "4" are explained in Codes in responses.

Authorizations

Authorization
string
header
required

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

Path Parameters

partner
string
required

Your platform's identifier. Firmable gives it to you during onboarding.

Body

application/json
filters
object

An object of filter identifier to an array of 1 to 100 codes. Codes within one filter are combined with OR. Different filters are combined with AND. Get codes from GET /filter-options. Accepts every company and people filter.

country
enum<string>[]

The markets to search, as market codes. Every market when omitted.

Available options:
AU,
NZ,
SG,
MY,
ID,
PH,
TH,
VN,
HK,
JP,
KR,
US,
CA
page
object

Response

Matching companies

records
object[]
total
integer

Total matching companies

page
object