---
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`

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/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)