Skip to main content
GET
Look up city and state by postal code

Authorizations

Authorization
string
header
required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Query Parameters

country
string
required

ISO 3166-1 alpha-2 country code. Only US has a dataset today.

Pattern: ^[A-Z]{2}$
code
string
required

Postal code to resolve (5-digit US ZIP).

Pattern: ^[0-9]{5}$

Response

City and state for the postal code.

country
string

ISO 3166-1 alpha-2 country code echoed back.

postal_code
string
city
string
state
string

ISO 3166-2 subdivision code suffix (e.g. FL).

Last modified on August 22, 2026