---
title: "Search the global GeoNames city catalogue"
method: GET
path: "/api/v1/locations/cities"
---

# Search the global GeoNames city catalogue

`GET /api/v1/locations/cities`

## Request

- Base URL: `https://streetproof.com`
- URL: `https://streetproof.com/api/v1/locations/cities`
- Auth: none required

Returns up to 30 GeoNames cities for a country. Catalogue availability is independent of StreetProof observation coverage.

## Query parameters

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

## Response `200`

GeoNames city options

- object
  - `schema` 'com.streetproof.geonames_city_options.v1'
  - `source` 'GeoNames cities500'
  - `country` string
  - `query` string
  - `cities` GeoNamesCity[]
    - `geonameId` integer
    - `name` string
    - `asciiName` string
    - `region` string, nullable
    - `countryCode` string
    - `countryName` string
    - `population` integer

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/streetproof/apis/streetproof-physical-brand-index-api.md) · [All operations](https://skmtc.dev/streetproof/apis/streetproof-physical-brand-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streetproof/apis/streetproof-physical-brand-index-api/revisions/81072718cfa2?raw)