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 fields

Derived from the example response.

okboolean

Whether the request succeeded.

dataobject

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

data.portsobject[]

Matching ports.

data.ports[].unlocodestring

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

data.ports[].namestring

Human-readable name.

data.ports[].country_codestring

ISO country code.

data.ports[].latnumber

Latitude.

data.ports[].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.