---
title: "Search cities"
method: POST
path: "/geo/cities"
tags: ["Geo"]
---

# Search cities

`POST /geo/cities`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/geo/cities`
- Auth: API key in header `Authorization`

Searches cities by name or country codes. Returns up to 100 cities per page.

## Request body

- SearchCitiesRequest
  - `query` string, nullable
  - `countryCodes` string[], nullable
  - `page` integer

## Response `200`

OK

- PaginatedListOfCityInfo
  - `items` CityInfo2[], required: The items in the list
    - `id` integer: The ID of the city
    - `name` string: The name of the city
    - `latitude` number, float, nullable: The latitude of the city
    - `longitude` number, float, nullable: The longitude of the city
  - `page` integer: The current page number. 1-indexed
  - `totalPages` integer: The total number of pages
  - `totalItems` integer: The total number of items in the list

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)