---
title: Get Geographic Locations
description: 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.
url: https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0
---

## GET /v0/catalog/locations — Get Geographic 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.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | query | integer or array<integer> | No | The ids of the locations |
| `name` | query | string | No | Search value for the location, this will be used to filter the locations by name |
| `country_code` | query | string | No | The country code of the location, all the returned locations will be filtered by this country code |
| `feature_code` | query | string or array<string> | No | 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 |
| `offset` | query | integer | No | The offset of the results |
| `limit` | query | integer | No | The limit of the results |

### Responses

#### 200 — Successful Response

#### 400 — Bad Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |

#### 402 — Payment Required

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |

#### 422 — Unprocessable Entity

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |

#### 500 — Internal Server Error

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |