GETAPI key

Lane rate cards

GETapi.freightratesmcp.com/lane/cards

Per-sailing rate cards for a lane, ordered by departure. Paginated: pass limit/offset and read total/has_more to walk every sailing.

Query parameters

polstringrequired

Port of loading UN/LOCODE.

podstringrequired

Port of discharge UN/LOCODE.

limitinteger

Page size, 1 to 1000 (the row ceiling). Defaults to 1000.

offsetinteger

Row cursor; use with limit to page through total. Defaults to 0.

carrierstring

Case-insensitive exact carrier filter.

etd_fromstring

Only sailings departing on or after this date-time (inclusive).

etd_tostring

Only sailings departing on or before this date-time (inclusive).

Response schema

28 fields

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

dataobject[]

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

data[]object

pol_codestring

pol_namestring

pol_countrystring

pod_codestring

pod_namestring

pod_countrystring

carrierstring

Carrier name, falling back to the SCAC when we hold no name.

vesselstring

Vessel currently carrying the container, or null when we hold neither a name nor an IMO. Its lat and lng are always null here; the keyed endpoints carry the live position under vessel_position.

voyagestring

Carrier voyage number, when published. Null otherwise.

service_modestring

is_viaboolean

transit_daysnumber

Port-to-port transit in days.

etdstring

Estimated time of departure (ISO 8601).

etastring

Arrival time (ISO 8601). Null when the carrier publishes none and we cannot predict one.

price_20gpany | null

price_40gpany | null

price_40hcnumber

currencystring

ISO currency code.

line_categorystring

valid_toany | null

source_updated_atstring

last_seen_atstring

rawobject

totalnumber

The allowance on your plan.

limitnumber

offsetnumber

has_moreboolean

True when another page is waiting behind next_cursor.

curl 'https://api.freightratesmcp.com/lane/cards?pol=CNSHA&pod=USLAX&limit=100&offset=0&carrier=MAERSK&etd_from=2026-09-01&etd_to=2026-09-30' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.freightratesmcp.com/lane/cards?pol=CNSHA&pod=USLAX&limit=100&offset=0&carrier=MAERSK&etd_from=2026-09-01&etd_to=2026-09-30", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.freightratesmcp.com/lane/cards?pol=CNSHA&pod=USLAX&limit=100&offset=0&carrier=MAERSK&etd_from=2026-09-01&etd_to=2026-09-30",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": [
    {
      "pol_code": "CNSHA", "pol_name": "Shanghai", "pol_country": "CN",
      "pod_code": "USLAX", "pod_name": "Los Angeles", "pod_country": "US",
      "carrier": "MAERSK", "vessel": "GEORG MAERSK", "voyage": "628E",
      "service_mode": "CY-CY", "is_via": false, "transit_days": 36,
      "etd": "2026-07-09T16:00:00Z", "eta": "2026-08-14T16:00:00Z",
      "price_20gp": null, "price_40gp": null, "price_40hc": 8480, "currency": "USD",
      "line_category": "美加线", "valid_to": null,
      "source_updated_at": "2026-07-08T19:16:09Z", "last_seen_at": "2026-07-08T19:16:09Z",
      "raw": {}
    }
  ],
  "total": 1103,
  "limit": 1000,
  "offset": 0,
  "has_more": true
}