GETAPI key

Find a location

GETapi.navo24.com/v1/distance/locations

Ports, airports, countries and, when nothing else fits, a geocoded address. Use it to check how a from or to will resolve.

Query parameters

qstringrequired

At least 2 characters: name, code or address.

typesstring

Comma-separated: port,airport,country,address. Default all.

geocodeboolean

false keeps the search offline (no address lookup). Default true.

limitinteger

1 to 50, default 10.

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

kindstring

carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.

locodestring

UN/LOCODE of the place.

namestring

Human-readable name.

countrystring

Country name.

country_codestring

ISO 3166-1 alpha-2 country code.

latnumber

Latitude.

lngnumber

Longitude.

curl 'https://api.navo24.com/v1/distance/locations?q=Hamburg&limit=4' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.navo24.com/v1/distance/locations?q=Hamburg&limit=4", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.navo24.com/v1/distance/locations?q=Hamburg&limit=4",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": [
    {
      "kind": "port",
      "locode": "DEHAM",
      "name": "Hamburg",
      "country": "Germany",
      "country_code": "DE",
      "lat": 53.54772,
      "lng": 9.96941
    },
    {
      "kind": "port",
      "locode": "USHAM",
      "name": "Hamburg",
      "country": "United States",
      "country_code": "US",
      "lat": 41.1534,
      "lng": -74.5762
    },
    {
      "kind": "port",
      "locode": "DEHBU",
      "name": "Hamburg-Harburg",
      "country": "Germany",
      "country_code": "DE",
      "lat": 53.47321,
      "lng": 9.96804
    },
    {
      "kind": "port",
      "locode": "DEHTJ",
      "name": "Hamburg-Mitte",
      "country": "Germany",
      "country_code": "DE",
      "lat": 53.55,
      "lng": 10.01667
    }
  ]
}