List job post locations

Job post locations are the join rows that attach one or more locations to a job_post — a multi-location posting (e.g. San Francisco, Remote (US), New York on a single role) has one row per location. GET /v3/job_posts does not return locations inline; pair this endpoint with it on job_post_id to assemble the candidate-facing location list. Filter with parent=job_post&ids=<job_post_id> to fetch every location on a specific post, or with parent=office / parent=custom_location to find every post in a given location.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

integer
1 to 500
Defaults to 100

Number of results per page

ids
array of integers
length ≤ 50

Comma separated list

ids
created_at
object
updated_at
object
office_ids
array of integers
length ≤ 50

Comma separated list

office_ids
job_post_ids
array of integers
length ≤ 50

Comma separated list

job_post_ids
custom_location_ids
array of integers
length ≤ 50

Return only job post locations linked to one of these job-board-scoped custom location ids. Custom locations are reusable, admin-defined location labels configured per job board (see GET /v3/job_boards), distinct from free-text strings and Greenhouse offices.

custom_location_ids
fields
array of strings
length ≤ 50

Comma separated list of fields to return

fields
string
enum

Filter by how the location is sourced. free_text returns admin-typed strings, office returns rows linked to an organization office, and custom_list returns rows linked to a board-scoped custom location.

Allowed:
string

Filter by exact match on the free-text location string (e.g. New York, NY). Only matches rows whose type is free_text; rows backed by an office or custom location are excluded.

Response

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