Skip to main content
Menu

← All endpoints

Bus Carrier Border Stats API Online

Border-crossing performance per bus carrier: crossings, average/median/min/max wait minutes — built from our own plate-matched crossing records.

GET https://nakordoni.eu/api/v1/data/bus-carriers — quota class: cheap

ParameterDescription
ppidCheckpoint ID, e.g. id_13 — or "all" for the aggregated roster
daysPeriod 1-90 (default 30)
min_crossingsMinimum crossings to include a carrier (default 3)
limitMax carriers returned (default 20)

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.

FieldDescription
data.companies[].nameCarrier, as matched from plates seen at the border.
data.companies[].crossingsHow many crossings of theirs we matched in the period.
data.companies[].avg_wait_minTheir average border wait, with median_wait_min, min_wait_min and max_wait_min.
data.companies[].max_wait_days_agoHow long ago the worst wait happened — an old outlier is not today's carrier.
data.total_crossingsCrossings observed in period_days, with matched_crossings — the subset a carrier could be identified for.
data.data_availablefalse = too little matched data for the checkpoint/period to report anything.
data.ppidCheckpoint the stats are for ('all' when aggregated), with mode and generated_at.
curl "https://nakordoni.eu/api/v1/data/bus-carriers?ppid=all&days=30" \
  -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