---
title: "List job post searchable locations"
method: GET
path: "/v3/job_post_searchable_locations"
tags: ["Job Post Searchable Locations"]
---

# List job post searchable locations

`GET /v3/job_post_searchable_locations`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/job_post_searchable_locations`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:job_post_searchable_locations:list`
  - HTTP bearer

Searchable locations are the individual geographic locations attached to a job post — one row per location, each with a formatted display string plus its component city, region (state/province), postal code, county, country, and latitude/longitude. A single job post can have many searchable locations. Each location's `id` is the searchable-location identifier used by downstream job boards: for example, Indeed composes its multi-location job identifier as `{job_post_id}_{id}`, so this endpoint is the canonical source for mapping those identifiers back to a job post and its location. Filter with `job_post_ids` to retrieve the locations for specific job posts. Results are scoped to the authenticated organization and to the locations the API user is permitted to access.

## 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
- `job_post_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `job_post_id` integer, nullable: Id of the job post this location belongs to. Use it with `GET /v3/job_posts` to look up the post, or as `job_post_ids` to filter this endpoint.
  - `location` string, nullable: Human-readable display string for the full location, typically `"City, Region, Country"` (for example, `"Chicago, IL, United States"`).
  - `city` string, nullable: City of the location.
  - `region_short_name` string, nullable: Abbreviated region (state or province) code, for example `"IL"`.
  - `region_long_name` string, nullable: Full region (state or province) name, for example `"Illinois"`.
  - `postal_code` string, nullable: Postal or ZIP code of the location.
  - `county` string, nullable: County (or equivalent administrative subdivision) of the location.
  - `country_short_name` string, nullable: Two-letter ISO 3166-1 alpha-2 country code, for example `"US"`.
  - `country_long_name` string, nullable: Full country name, for example `"United States"`.
  - `latitude` number, nullable: Latitude of the location in decimal degrees.
  - `longitude` number, nullable: Longitude of the location in decimal degrees.

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)