---
title: "List job board custom locations"
method: GET
path: "/v3/job_board_custom_locations"
tags: ["Job Board Custom Locations"]
---

# List job board custom locations

`GET /v3/job_board_custom_locations`

Job board custom locations are the curated list of location strings a site admin maintains for posting jobs to a given job board. Each row belongs to exactly one `greenhouse_job_board` and backs the `custom_list` mode of `/v3/job_post_locations` — when a post references a custom location via `custom_location_id`, its displayable text is resolved from the matching row's `value`. Boards configured to use organization offices or free-text strings do not produce rows here; filter by `greenhouse_job_board_ids` to scope to a specific board.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `greenhouse_job_board_ids` integer[]
- `fields` string[]
- `active` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `value` string — Location string shown to job post creators in the per-board dropdown (e.g. `New York, NY`, `Remote (US)`). Site admins curate one row per line in the job board's location settings; the same `value` is used verbatim on `job_post_locations` rows whose `type` is `custom_list`.
  - `active` boolean — `true` while the location is selectable on new and edited job posts. Set to `false` after removal — historical `job_post_locations` rows that already reference this id are preserved so existing posts still resolve their displayable location.
  - `greenhouse_job_board_id` integer — Id of the job board this location is scoped to. Custom locations are board-scoped — a given location belongs to exactly one board, and a post may only reference a custom location whose `greenhouse_job_board_id` matches its own.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)