Skip to main content
POST
Resolve place names to canonical Place ids

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required

The place name to resolve, such as "redstone arsenal".

Maximum string length: 200
categories
enum<string>[]

Restrict to these place categories, to disambiguate a name shared across categories.

Available options:
postal_code,
county,
municipality,
region,
country,
military_installation,
school_district
isoCodes
string[]

Restrict to these jurisdiction codes, matched exactly (e.g. US-NC). Not hierarchical — "US" matches only the country record.

cursor
string

Opaque cursor from the previous response's meta.nextCursor. Omit for the first page. Only valid for the exact query, categories, and isoCodes that produced it.

perPage
integer
default:25

Results per page. Default 25, maximum 100.

Required range: x <= 100

Response

Matching places

data
object[]
required
meta
object
required

Cursor-paginated result metadata for place search.