Search cities

post

https://api.companyenrich.com/v2/geo/cities

Searches names using a literal, case-insensitive substring. Results use cursor pagination in stable code or ID order. Cursors expire 30 minutes after the first page; keep the same filters when continuing. This endpoint does not consume credits.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

stateIds

array of int32s | null

Up to 100 positive state IDs. Results may belong to any supplied state and must also match any country filter.

stateIds

countryCodes

array of strings | null

Up to 250 two-letter country codes. Results may belong to any supplied country. Codes are trimmed and case-insensitive.

countryCodes

query

string | null

A literal, case-insensitive substring of the name. Leading and trailing whitespace is ignored.

pageSize

int32

1 to 100

The maximum number of results to return. Defaults to 100.

cursor

string | null

The cursor from the previous response. Omit for the first page. Keep the same filters; pageSize may change.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200OK

400Bad Request

401Unauthorized

402Payment Required

422Unprocessable Entity

429Too Many Requests