Search employers

Search and page through the company's employers using the flattened field contract.

Searches employers in the caller's company. Returns a page of employers
matching the supplied filters. Use the employer metadata endpoint
(/v1/employers/metadata/search) to discover available field IDs and
supported filter operators. There is no single-employer endpoint — read one
employer by filtering on /employer/id.

Before using this endpoint

  • Discover readable field IDs (including custom fields) via the
    employer metadata search endpoint.
    Out-of-the-box field IDs are also listed as keys on the Employer response
    schema for this search endpoint.
  • There is no single-employer endpoint — filter on /employer/id with
    operator equals to read one employer.
  • Filterable field IDs: /employer/id, /employer/legalName,
    /employer/country, /employer/employerStatus,
    /employer/supportsRemoteWorkers. Any other fieldId in filters returns
    400 Bad Request.

Pagination — cursor-based. The first page is requested without cursor;
subsequent pages pass next_cursor from the previous response.
next_cursor is null on the last page. Search does not support sorting —
order results client-side.

Testing notes

  • Use the testing widget's Try It! option to test this endpoint.
  • Open Examples and select Request Example to populate the request
    body. The default example returns all employers with a core field set.
  • IDs must be sent as JSON strings even when they look numeric, so that
    large values are not truncated by JSON number precision in clients.

OAuth scope (app-user): employers:read.
IAM permission: Settings / Employers / View (company-scoped).

Body Params

Request body for employer search. filters is required — send an empty array
([]) to return every employer the caller can view. fields is optional;
omit it to return all available fields. limit defaults to 50.

Request body for employer search. filters is required — send an empty array
([]) to return every employer the caller can view. fields is optional;
omit it to return all available fields. limit defaults to 50.

fields
array of strings | null
Defaults to /employer/id,/employer/legalName,/employer/country,/employer/employerStatus

Field IDs to include in each result item. When omitted, all available
fields are returned. Discover the authoritative field catalog (including
custom fields) via the employer metadata search endpoint; out-of-the-box
field IDs are also listed as keys on the Employer response schema.

fields
filters
array of objects
required
Defaults to []

Filters to apply. An empty list returns every employer the caller has
permission to view.

filters*
integer | null
1 to 200
Defaults to 50

Maximum number of items per page (allowed range 1–200). Defaults to 50.

string | null

Opaque cursor from a previous response's response_metadata.next_cursor.
Omit on the first request.

Responses

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json