News submission and NakBus fleet are now in the partner dashboard
Connect your developer account to a Nakordoni Partners account with the same email and manage news and your bus fleet (NakDriver / NakManager) there, with team roles. Your API keys, endpoints and apps are unchanged, and the pages here keep working. Open Nakordoni Partners
Best Time to Cross API Online
Typical-week load statistics per checkpoint: 7×24 day-of-week × hour matrix (median + p25/p75 band), quietest/busiest day, best/worst 2-hour windows.
GET https://nakordoni.eu/api/v1/data/day-stats
— quota class: cheap
| Parameter | Description |
|---|---|
ppid | Checkpoint ID |
lang | Language code |
Response fields — inside the data object of the envelope. [] marks a list, so data.items[].name is the name field of each element. A field is null, absent or an empty list when we hold no value for it — never a placeholder.
| Field | Description |
|---|---|
data.matrix | 7×24 median queue: matrix[dayOfWeek][hour], day 0 = Monday, hours in the checkpoint's timezone (data.tz). |
data.lo | Same 7×24 shape — the p25 floor of the band; hi is the p75 ceiling. |
data.counts | Observations behind each cell — a cell with few counts is a weak median. |
data.weekday_avg | Seven averages, one per weekday; best_day and worst_day index into them. |
data.best_slots[] | Quietest 2-hour windows: dow, hour, v (the value). worst_slots is the same for the busiest. |
data.overall_avg | Average across the whole matrix, with overall_max. |
data.samples | Readings the matrix was built from, over period_days; data_quality grades that sample. |
data.data_quality | 'high' = the matrix is this checkpoint's OWN observations. 'low' = there was not enough direct history, so the mirror direction's matrix is returned as an estimate — see estimated_from. |
data.estimated_from | Present only when data_quality is low: the ppid the matrix actually came from (the same crossing in the opposite direction, same vehicle type). The numbers are NOT observations of the checkpoint you asked for — do not feed them to a model as if they were. data_quality_note carries the same warning as prose. |
data.generated_at | When the matrix was last recomputed (unix). It is precomputed daily, not per request. |
curl "https://nakordoni.eu/api/v1/data/day-stats?ppid=id_13&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. Log in
Updated