Skip to content
Navo24 Navo24
GETAPI key

Place details

GETapi.navo24.com/v1/geo/place

One place by id with every code we hold for it and its names in every language. Use it after search to show a full card or to store the codes.

Query parameters

idintegerrequired

Place id from search, reverse or hubs.

Response schema

18 fields

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

dataobject

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

idnumber

Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.

kindstring

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

namestring

Human-readable name.

country_codestring

ISO 3166-1 alpha-2 country code.

latnumber

Latitude.

lngnumber

Longitude.

populationnumber
timezonestring

IANA time zone of the place. Null when we could not resolve the port.

locodestring

UN/LOCODE of the place.

iatastring

IATA code.

codesobject[]
codes[]object
typestring

Event code, for example DEPA or LOAD.

codestring

Event or status code.

namesobject
bgstring[]
altstring[]
lastring[]

Errors

A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.

missing_key401

No Authorization: Bearer *** or X-API-Key header.

invalid_key401

The key was not recognised.

not_found404

No place has this id.

curl 'https://api.navo24.com/v1/geo/place?id=698740' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"
Response
{
  "data": {
    "id": 698740,
    "kind": "city",
    "name": "Odesa",
    "country_code": "UA",
    "lat": 46.48572,
    "lng": 30.74383,
    "population": 1010537,
    "timezone": "Europe/Kyiv",
    "locode": "UAODS",
    "iata": "ODS",
    "codes": [
      { "type": "locode", "code": "UAODS" },
      { "type": "iata", "code": "ODS" }
    ],
    "names": {
      "bg": ["Одеса"],
      "alt": ["Odessa"],
      "la": ["Odessus"]
    }
  }
}