GETAPI key

Postal code lookup

GETapi.navo24.com/v1/geo/postal

Postal code to place and coordinates. 1.8 million codes in about 100 countries.

Query parameters

codestringrequired

The postal code as written locally.

ccstring

ISO 3166-1 alpha-2 country. Recommended: the same code exists in many countries.

Response schema

8 fields

Derived from the example response, nested as the JSON is.

dataobject[]

The payload. Everything an endpoint returns sits under this key.

data[]object

country_codestring

ISO 3166-1 alpha-2 country code.

postal_codestring

placestring

statestring

Why the field stands where it does: resolved, contract_required, not_published, not_applicable or awaiting_carrier.

countystring

latnumber

Latitude.

lngnumber

Longitude.

curl 'https://api.navo24.com/v1/geo/postal?code=65000&cc=UA' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.navo24.com/v1/geo/postal?code=65000&cc=UA", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.navo24.com/v1/geo/postal?code=65000&cc=UA",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": [
    {
      "country_code": "UA",
      "postal_code": "65000",
      "place": "Одеса",
      "state": "Odeska",
      "county": "Odeska",
      "lat": 46.4775,
      "lng": 30.7326
    }
  ]
}