Reliability on a lane
Carriers on a lane, ranked by observed on-time performance.
Counted: 1 call for each answer that carries data. Free: a lane with no carriers observed (an empty carriers list), and any refusal or error. See how calls are counted.
Query parameters
Origin UN/LOCODE.
Destination UN/LOCODE.
Response schema
8 fields
Derived from the example response, nested as the JSON is.
Whether the request succeeded.
data
The payload. Everything an endpoint returns sits under this key.
Carriers, ranked.
carriers[]
Carrier SCAC.
Carrier name.
Share of sailings that arrived on time.
Average delay in hours.
Number of observed sailings behind the figure.
Errors
Every refusal is { "ok": false, "error": { "code", "message" } }. Branch on the code, and log the message. No refusal or error is counted as a call.
The key is missing, unknown, revoked or past its own expiry date. Not counted.
SchedulesMCP is not connected to your account. Not counted.
Your account's access period has ended. Not counted.
The monthly call limit or the key's daily limit is spent. Retry-After gives the seconds until it resets. Not counted.
Too many requests in a short window. Wait Retry-After seconds. Not counted.
Access could not be checked just now, so the request was not run. Retry after Retry-After. Not counted.
curl 'https://api.schedulesmcp.com/public/reliability/lanes?origin=CNSHA&destination=NLRTM' \
-H "Authorization: Bearer smcp_YOUR_API_KEY"const res = await fetch("https://api.schedulesmcp.com/public/reliability/lanes?origin=CNSHA&destination=NLRTM", {
headers: {
"Authorization": "Bearer smcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.get(
"https://api.schedulesmcp.com/public/reliability/lanes?origin=CNSHA&destination=NLRTM",
headers={"Authorization": "Bearer smcp_YOUR_API_KEY"},
)
data = res.json(){
"ok": true,
"data": {
"carriers": [
{ "carrier_code": "CMDU", "carrier_name": "CMA CGM",
"on_time_pct": 82, "avg_delay_hours": 14,
"observations": 41 }
]
}
}