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 theEmployerresponse
schema for this search endpoint. - There is no single-employer endpoint — filter on
/employer/idwith
operatorequalsto read one employer. - Filterable field IDs:
/employer/id,/employer/legalName,
/employer/country,/employer/employerStatus,
/employer/supportsRemoteWorkers. Any otherfieldIdinfiltersreturns
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).

