A company's open reqs, deduped across boards

The company's current active reqs, deduped across boards -- LinkedIn-excluded: ATS tenants plus public job boards and aggregators; each row's boards names its source. Freshness-floored. The same real req posted on two boards appears once, with both boards listed.

An unresolvable function -- anything that is not a function taxonomy id -- is rejected with 422 instead of returning a silently-empty result. limit is bounded: an oversized page is rejected with 422 rather than truncated.

Requires the read scope.

get/v1/companies/{company_id}/open-reqs

Request

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

Path parameters

company_idinteger required

The plane's company id -- returned as company_id by /v1/reqs/search and by every company motion response.

Query parameters

functionstring nullable

Filter to one function: its name as served in function_name, e.g. 'Software & IT', or its taxonomy id as served in function, e.g. '54f81306-3000-5c4a-a088-dca4350b19ff'. A name covers every function id that serves it; an id matches that one id. Anything else is rejected with 422, which lists the names.

countrystring nullable

Filter to one country by name, e.g. 'United States'. Matched against the geocoder's pinned country list.

limitinteger

Maximum reqs to return. An out-of-range value is rejected with 422 rather than silently truncated.

Headers

Idempotency-Keystring nullable

Response

Successful Response

as_ofstring date-time required
coverage_status'ats_direct_hit' | 'board_hit' | 'no_ats_signal' | 'unsupported_ats' required

Changes

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