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 <a href="https://apidocs.hibob.com/reference/post_employers-metadata-search" target="_blank">employer metadata search endpoint</a>. 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).