---
title: "Get Geographic Locations"
method: GET
path: "/v0/catalog/locations"
tags: ["Catalog"]
---

# Get Geographic Locations

`GET /v0/catalog/locations`

Search for geographic locations by name or ID to retrieve standardized location data including city, region, and country. Use location IDs with job_location_or and job_location_not filters for precise geographic targeting in job searches.

## Query parameters

- `id` union — The ids of the locations
  - integer
  - integer[]
- `name` string, nullable — Search value for the location, this will be used to filter the locations by name
- `country_code` string, nullable — The country code of the location, all the returned locations will be filtered by this country code
- `feature_code` union — GeoNames feature code(s) to filter by location type (e.g. PPL=populated place, ADM1=first-order admin division). See https://www.geonames.org/export/codes.html
  - string
  - string[]
- `offset` integer — The offset of the results
- `limit` integer — The limit of the results

## Response `200`

Successful Response

- GeonameCatalogResponse[]
  - `id` integer, required — The unique identifier for the location, is based on the geonameid field from the geonames database
  - `name` string, required — The name of the location
  - `admin1_name` string, nullable — The name of the first-level administrative division (e.g., state or province) of the location
  - `country_code` string, nullable — The ISO 3166-1 alpha-2 code of the country of the location
  - `feature_code` string, required — The feature code of the location
  - `feature_name` 'city' | 'region' | 'country' | 'continent', required
  - `display_name` string, required
  - `country_name` string, nullable, required

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)