GETNo key

Resolve a port

GETapi.schedulesmcp.com/public/ports/search

Turn a port name into a UN/LOCODE. No key required.

Query parameters

namestringrequired

Port name, partial name, or UN/LOCODE. Minimum 2 characters. Also accepted as q, which is the older spelling and still supported.

limitinteger

Max results. Default 8, maximum 20.

Response schema

8 fields

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

okboolean

Whether the request succeeded.

dataobject

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

portsobject[]

Matching ports.

ports[]object

unlocodestring

UN/LOCODE port code. On a tracking event it is canonicalised, and null when the carrier named no port.

namestring

Human-readable name.

country_codestring

ISO 3166-1 alpha-2 country code.

latnumber

Latitude.

lngnumber

Longitude.

Try it No key

name * query limit query

curl 'https://api.schedulesmcp.com/public/ports/search?name=rotterdam'

const res = await fetch("https://api.schedulesmcp.com/public/ports/search?name=rotterdam");
const data = await res.json();

import requests

res = requests.get("https://api.schedulesmcp.com/public/ports/search?name=rotterdam")
data = res.json()

Sample response example

{
  "ok": true,
  "data": {
    "ports": [
      { "unlocode": "NLRTM", "name": "Rotterdam",
        "country_code": "NL", "lat": 51.9167, "lng": 4.5 }
    ]
  }
}

This preview uses documented example data and makes no live request. Get a key to run live.