Search and page through a specific employer's work locations.
Searches the work locations of a single employer, identified by the path
parameter {employerId}. Returns a page of work locations matching the
supplied filters. Use the work-location metadata endpoint
(/v1/employers/work-locations/metadata/search) to discover
available field IDs and supported filter operators. There is no
single-work-location endpoint — read one by filtering on /workLocation/id.
(Work-location metadata is not employer-scoped; its endpoint is
/v1/employers/work-locations/metadata/search.)
Before using this endpoint
- Discover readable field IDs (including custom fields) via the
work-location metadata search endpoint.
Out-of-the-box field IDs are also listed as keys on theWorkLocation
response schema for this search endpoint. - Provide a numeric
employerIdin the path — use the employer search
endpoint to look up employer IDs. - There is no single-work-location endpoint — filter on
/workLocation/id
with operatorequalsto read one work location. - Filterable field IDs:
/workLocation/id,/workLocation/name,
/workLocation/type,/workLocation/status,/workLocation/country. Any
otherfieldIdinfiltersreturns 400 Bad Request.
Pagination — cursor-based. 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. Replace the pathemployerIdwith a real employer ID from your
company. - IDs must be sent as JSON strings even when they look numeric.
OAuth scope (app-user): employers:read.
IAM permission: Settings / Employers / View (company-scoped).

