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.
Your account has no Schedules API access, or the key is not enabled for it. Not counted.
The access of your account, or of the key, has ended. Not counted.
The monthly call limit of your account or of the key, or the key's daily limit, is spent. Retry-After gives the seconds until it resets. A refused call is not counted.
Too many requests in a short window. Wait Retry-After seconds. A refused call is 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 }
]
}
}