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
Live Queue & Freshness API Online
When a checkpoint was last updated, by which source, and a freshness rating.
GET https://nakordoni.eu/api/v1/data/update-info
— quota class: cheap
| Parameter | Description |
|---|---|
ppid | Checkpoint ID, e.g. id_13 (see /api/v1/data/checkpoints) |
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.queue_now | Vehicles in the queue at the latest reading. |
data.timestamp | When that reading was taken (unix), with datetime and timezone — the checkpoint's own zone. |
data.age_seconds | How old the reading is now, also as age_minutes and age_hours. |
data.freshness | Plain-language band for that age. is_realtime says the row is an observation rather than a forecast point — it does NOT say the observation was counted; read data_quality for that. |
data.data_quality | high = the reading was counted from a real observation source at the crossing; low = a modelled estimate, because that checkpoint has no counting source. Same high|low vocabulary as the checkpoints directory, Border Queue and Best Time to Cross. Both are real answers; low is not an error, but do not present a low value to drivers as a measurement. |
data.found | false = we monitor the checkpoint but hold no reading; status carries the reason. |
data.origin | Which upstream the reading came from. |
curl "https://nakordoni.eu/api/v1/data/update-info?ppid=id_13" \ -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