Carrier league table
The on-time league across all observed lanes. Carriers with 20+ observations are ranked; the rest follow, unranked.
Counted: 1 call for each answer that carries data. Free: an empty table (an empty carriers list), and any refusal or error. See how calls are counted.
Query parameters
How many carriers to return, 1 to 100. Ranked carriers come first.
Response schema
11 fields
Nested exactly as the JSON is. Open a branch to read its fields; hover a name for the full dot-path.
data
Observations a carrier needs to be ranked: 20.
Carriers in the table, before limit.
How many of them are ranked.
Ranked carriers first, by on-time share. Then carriers with fewer than 20 observations, unranked.
carriers[]
Place in the league. Null for a carrier with too little data.
True when the carrier has a place.
True when the carrier has fewer than 20 observations. Its percentage is indicative.
Carrier SCAC.
Carrier name.
Share of sailings that arrived on time.
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/leaderboard' \
-H "Authorization: Bearer smcp_YOUR_API_KEY"const res = await fetch("https://api.schedulesmcp.com/public/reliability/leaderboard", {
headers: {
"Authorization": "Bearer smcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.get(
"https://api.schedulesmcp.com/public/reliability/leaderboard",
headers={"Authorization": "Bearer smcp_YOUR_API_KEY"},
)
data = res.json(){
"ok": true,
"data": {
"min_obs": 20,
"total": 65,
"ranked_total": 39,
"carriers": [
{ "rank": 1, "ranked": true, "provisional": false,
"carrier_code": "CMDU", "carrier_name": "CMA CGM",
"on_time_pct": 88, "observations": 214 },
{ "rank": null, "ranked": false, "provisional": true,
"carrier_code": "ONEY", "carrier_name": "ONE",
"on_time_pct": 100, "observations": 12 }
]
}
}