---
title: "Search locations"
method: GET
path: "/locations/search"
tags: ["Locations"]
---

# Search locations

`GET /locations/search`

Canonical place autocomplete. Job locations must reference a suggestion's `locationId`. Free-typed places are rejected.

## Query parameters

- `q` string, required
- `country` string

## Response `200`

Matching places, best first.

- object
  - `items` LocationSuggestion[]
    - `locationId` integer
    - `displayName` string
    - `city` string
    - `stateProvince` string
    - `country` string

## Other responses

- `401` — Missing, unknown, or revoked partner key.

---

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