Find a company's id by domain or name

Turn a website or a company name into the company_id every company-scoped endpoint takes.

Pass exactly one of domain or name; both or neither is a 422 naming that rule. A domain returns the companies registered at it; a name returns up to five candidates, each with a match_confidence -- 1.0 for an exact name, 0.8 for a match once legal suffixes are dropped.

Each company carries its country_code and coverage_status, and no hiring signal -- ask /v1/companies/{company_id}/is-hiring for that. Nothing matching is an empty array, never a 404. Not billable.

Requires the read scope.

get/v1/companies/resolve

Request

  • Base URL: https://api.reqbeat.com
  • URL: https://api.reqbeat.com/v1/companies/resolve
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

domainstring nullable

The company's website: a bare host ('stripe.com') or a full URL ('https://www.stripe.com/jobs'). Matched exactly once the scheme, path and 'www.' are dropped. Pass this or name, not both.

namestring nullable

The company's name, matched case-insensitively and then with legal suffixes dropped. Pass this or domain, not both.

Response

Successful Response

company_idinteger required
company_namestring nullable required
company_domainstring nullable required
country_codestring nullable required

The posting country's ISO-3166-1 alpha-2 code, uppercase (DE, US), derived from country and never stored. null when country is absent or is not a country this corpus names — never a guess. Note this is an output only: the geo/country filter still takes the name, because a bare two-letter code is ambiguous on input (CA is Canada to ISO and California to this column).

coverage_status'ats_direct_hit' | 'board_hit' | 'no_ats_signal' | 'unsupported_ats' required
match_confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.