Build with real border-crossing data
The data behind nakordoni.eu — live queues at European border checkpoints, machine-learning forecasts, years of historical statistics, EU fuel prices and 14,000+ driver POIs — available as a clean, documented JSON API.
Available products
API Status
Live health of every Developer-API product: online / degraded / offline, response latency and last-checked time, plus an overall rollup. Public — no API key required.
/api/v1/data/status
Checkpoints Directory API
Directory of all monitored border checkpoints: IDs, names, countries, coordinates and status. Use it to discover ppid values for the other APIs.
/api/v1/data/checkpoints
Multi-Checkpoint API
Fetch live queue status and/or data freshness for up to 5 checkpoints in a single request. Quota counts as ⌈(N PPIDs × sub-products) / 2⌉ — 50% cheaper than the equivalent individual calls. Use include=queue,update-info to get both datasets at once. From 2026-08-30 a request that lists more than 5 PPIDs is answered for its first 5 only: the rest are ignored (echoed back in meta.ppid_cap.ignored) and are not billed.
/api/v1/data/multi?ppids=id_2,id_13,id_15&include=queue,update-info&lang=en
Border Queue API
All checkpoints on a given border + vehicle type in one call — live queue, wait estimate, and data freshness for every crossing. Supports single destination, comma-separated list, or "all". Results sorted by queue length ascending.
/api/v1/data/border/1/all/4
Checkpoint Search API
Find checkpoint PPIDs by name in any language. Returns all PPIDs for that location grouped by vehicle type. Up to 20 names per request.
/api/v1/data/search?name=Krakovets,Shehyni&lang=en
Live Border Queue API
Real-time queue length, wait estimate and status for any monitored checkpoint. Includes a snapshot block: current queue (queue_now), prognosed wait time wait_min = tmin + queue × tpercar, data age and source.
/api/v1/data/queue?ppid=id_13
Advanced Wait Time API
Wait time adjusted for live traffic flow and weather, with a full breakdown of each adjustment, plus the same wait_status/trend fields as border and multi. Billed at 1.5x a normal heavy-class call, reflecting the extra traffic/weather/driver-report lookups. Granted on request.
/api/v1/data/queue-advanced?ppid=id_13
Checkpoint Hourly Statistics API
Hourly historical queue stats per checkpoint and date: 24 hourly values, daily avg/min/max, peak and quietest hours, day-over-day comparison.
/api/v1/data/stats?ppid=id_15&date=2026-06-01&compare=1
Best Time to Cross API
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.
/api/v1/data/day-stats?ppid=id_13&lang=en
Queue Forecast API
ML ensemble forecast of queue levels: 24-hour and 7-day (168h) horizons with confidence bounds. The same model that powers nakordoni.eu predictions.
/api/v1/data/forecast?ppid=id_13&prediction_steps=24
Checkpoint Alternatives API
Nearby alternative checkpoints on the same border with current queues and distance deltas.
/api/v1/data/alternatives?ppid=id_13&crossing_type=4
Live Queue & Freshness API
When a checkpoint was last updated, by which source, and a freshness rating.
/api/v1/data/update-info?ppid=id_13
EU Fuel Prices API
Fuel prices across EU countries — country averages, nearest stations by coordinates, or stations near a border checkpoint. Aggregated from official national price registries and market data.
/api/v1/data/fuel?country=PL
Fuel Prices by City API
Per-city fuel price summary for a country: cheapest station price and average across the top 5 stations in each major city.
/api/v1/data/fuel-cities?country=hr&fuel_type=diesel&lang=en
Driver POIs API
Truck parkings (14k+), free showers, services and supermarkets across Europe with coordinates. Results are sorted closest-first with distance_km. Locate by lat/lon or by city (+country).
/api/v1/data/pois?type=parking&lat=50.7&lon=23.9&radius=50
Truck Parking API
The closest truck parkings, Autohöfe and truck stops to a point or city — sorted by distance with distance_km, name, coordinates and country. 14k+ locations across Europe.
/api/v2/data/truck-parkings?city=Katowice&country=PL&radius=40
Nearby Shops API
The closest supermarkets and grocery shops to a point or city — sorted by distance with distance_km, name, coordinates and country.
/api/v2/data/shops?city=Przemysl&country=PL&radius=20
Free Showers API
The closest free showers for drivers to a point or city — sorted by distance with distance_km, name, coordinates and country.
/api/v2/data/showers?lat=50.7&lon=23.9&radius=50
Driver Restaurants API
The closest driver-friendly restaurants to a point or city — sorted by distance with distance_km, name, coordinates and country.
/api/v2/data/restaurants?city=Lublin&country=PL&radius=30
Industrial Zones API
The closest industrial and logistics zones to a point or city (3k+ across Europe) — sorted by distance with distance_km, name, coordinates and country.
/api/v2/data/industrial?city=Duisburg&country=DE&radius=40
Nearby Fuel Stations API
The closest petrol stations to a point or city with current prices per fuel type, sorted by distance. Station-level coverage: DE, IT, FR, AT, ES, SI, HR, LU, PT, DK (same data as the nakordoni.eu fuel pages; use the fuel API country mode for national averages elsewhere). When no stations match, the response includes a coverage object naming the covered countries instead of a silent empty list.
/api/v2/data/fuel-stations?city=Munich&country=DE&radius_km=20&fuel_type=diesel
Internet Points API
Mobile-operator shops and WiFi points useful to drivers on the road, nearest-first from a point or city with distance_km.
/api/v2/data/internet-points?lat=52.2&lon=21.0
Vignettes & Road Tolls API
Whether a country requires a vignette for highway travel, current prices per duration and where to read more — per country or for a whole trip.
/api/v2/data/vignettes?country=AT
Cheapest Fuel Nearby API
The cheapest petrol stations around a point or city, ranked by price for the chosen fuel type (closest wins a tie). Station-level coverage: DE, IT, FR, AT, ES, SI, HR, LU, PT, DK. When no stations match, the response includes a coverage object naming the covered countries instead of a silent empty list.
/api/v2/data/fuel-cheapest?city=Munich&country=DE&radius_km=25
Fuel Grade Names API
The naming table behind every fuel product: our canonical grade codes and the name each grade carries at a pump in 41 European countries — ON in Poland, Nafta in Czechia, Gázolaj in Hungary, Motorină in Romania, ДП in Ukraine, Motorin in Turkey. Every name in the table is accepted by the fuel_type parameter of the other fuel products, and is resolved country-first: “95” is E10 at a Danish pump and E5 at a Polish one.
/api/v2/data/fuel-grades?country=PL&fuel_type=ON
Local Fuel Price API
Best available fuel price for any point in Europe, resolved down a three-tier ladder. Where we have station-level data (DE, IT, FR, AT, ES, SI, HR, LU, PT, DK and the Polish Tricity area) it returns prices at the nearest stations; for a point in Ukraine, where per-station prices exist nowhere, the average for the oblast the point falls in (ISO 3166-2 code, for example UA-46); otherwise the national average of the country the point falls in. Every response names the tier that answered in a resolution field: station, region or country.
/api/v2/data/fuel-local?lat=50.45&lon=30.52&lang=uk
Currency Exchange Rates API
EUR-based exchange rates for PLN, CZK, HUF, USD, GBP, CHF, NOK and UAH, sourced from Frankfurter (ECB), cached 6 hours. No parameters — always returns the full rate table.
/api/v1/data/currency
Truck Driving Bans API
European truck driving restrictions for one or more countries, including seasonal and holiday bans. Each ban carries its restriction type (General / Local / Sunday / Holiday / Seasonal), the exact scope or roads affected and the minimum weight, and each country a live status computed in its own timezone (active_window / next_window), plus a covered_countries list. Scoped per country: country is required and accepts a comma-separated list of up to 10 codes. The response also reports returned, total_available and truncated, so a capped answer is never mistaken for a complete one.
/api/v1/data/truck-bans?country=PL
Free embeddable widget: show live EU truck driving bans on your own website — 3 designs, 25 languages, no API key required. Get the embed code
Trading Sundays API
Sunday retail-opening regulations and upcoming trading Sundays per regulated EU country.
/api/v1/data/trading-sundays?country=PL
Holiday Calendar API
Official public holidays per European country — dates, local names and type, each country's full holiday list included. Backed by the same Nager.Date / OpenHolidaysAPI service (7-day cache, locally-computed Kosovo calendar) that powers the nakordoni.eu holiday calendar page and the prediction system's calendar factors. One country returns a flat object; several return the same shape wrapped in a list. upcoming=1 switches to a flat, date-sorted cross-country feed; compare_to switches to a same-vs-different comparison across countries, useful for checking whether a date is a holiday on both sides of a border crossing or just one.
/api/v1/data/holiday-calendar?country=PL&compare_to=UA&year=2026&lang=en
Border Weather Condition API
The road hazard at a checkpoint on a single 0–5 scale: clear road, fog, snow, rain, ice or strong wind — named in your language, graded by severity, with the age of the marker and whether a driver or our own model reported it.
/api/v1/data/weather?ppid=id_13&lang=en
Bus Carrier Border Stats API
Border-crossing performance per bus carrier: crossings, average/median/min/max wait minutes — built from our own plate-matched crossing records.
/api/v1/data/bus-carriers?ppid=all&days=30
Road Conditions API
Approved road condition reports near borders and on major corridors: potholes, roadworks, closures, ice, hazards — combining driver reports with automatic accelerometer detections from our navigation app.
/api/v1/data/road-conditions?ppid=id_13&lang=en
Border AI Assistant API
Ask our production AI assistant any border-crossing question (queues, forecasts, rules, fuel, routes) and get the same grounded answer that powers the nakordoni.eu widget — in 24 languages. Already used in production by yaknakordoni.com.ua.
/api/v1/data/assistant?q=How long is the queue at Krakovets now?&lang=en&ppid=id_13
Personalised AI Assistant API
Your own AI assistant, grounded on YOUR content plus OUR live border data. Point it at your markdown files or let us fetch the pages you name — we index them and answer from them. Choose which of our data feeds it may use (queue, forecast, alternatives, fuel, truck bans, holidays, road conditions…), choose the model tier (that is what sets the price), write your own instructions with {{feed.slug}} placeholders saying exactly where our data goes in the answer, and add a closing sentence of your own that is appended to every reply. Build it and test it at /{lang}/developers/studio, then call it here. Price per answer = model tier units + 1 unit per enabled feed (shown in the studio and in X-Devapi-Units).
/api/v2/data/assistant-custom?assistant_id=1&q=Should I cross tonight or in the morning?&ppid=id_13&lang=uk
Border Travel Matrix API
Travel time + border queue data for all checkpoints from a given origin. Returns drive time, current queue, total estimated journey time, and distance for every relevant crossing — sorted by fastest route.
/api/v1/data/travel-matrix?origin_lat=50.06&origin_lon=19.94&type=4&dest=all&lang=en
Air Alert Proximity API
Air-raid alerts and airborne objects near ONE border crossing. Anchor on a checkpoint (ppid), a coordinate pair or a city and get back only what is inside your radius (default 100 km): which regions are under alert, how far each is, and how close any tracked object currently is on a 1-5 proximity band. Regions are returned as ISO 3166-2 region_code, the same classifier the regional fuel data uses. DELIBERATELY NOT REAL-TIME: every response is a snapshot 1-3 minutes old with the lag re-randomised per request and stated in as_of/lag_min, and object coordinates are never returned - only distance, bearing and speed relative to your anchor. Source data is crowd/OSINT-derived and partly hand-moderated: a signal, never ground truth, and never a substitute for official air-raid warnings.
/api/v2/data/air-alerts?ppid=id_94&radius_km=100
Route Planner API
A door-to-door plan for a border trip: the route, the crossings on it with a live queue or a forecast for your arrival time, and the rest, meal and refuelling stops a driver really makes — all on one timeline. A long queue counts as the break that was already due, so waiting is never counted twice; buses and trucks get the mandatory EU 561/2006 rest, and bus service stops are calibrated on more than 1000 licensed coach schedules. Each border also reports wait_basis: vehicle_lane when your vehicle class has its own measured queue, car_lane when the car-lane queue is the best available signal.
/api/v2/data/route-plan?origin_lat=50.4501&origin_lon=30.5234&dest_lat=52.2297&dest_lon=21.0122&vehicle=car&stop_places=1&lang=en
Road Quality API
Road roughness scores per corridor computed from anonymized accelerometer telemetry of real drives: roughness index 0-100, pothole density per km, rough-corridor clusters with coordinates. (Coming soon)
Coming soonFleet Vehicles API
Your own NakBus Live fleet: every vehicle registered to your company with plate, label, assigned route, public-map flag, status, whether a driver device is currently on shift, and the last measured timetable delay. Owner-scoped — the key sees its own fleet only, including vehicles hidden from the public bus map. Activate fleet tracking at nakordoni.eu/en/developers/fleet (first bus free).
/api/v2/data/fleet/vehicles
Fleet Live Positions API
Where your buses are right now — one row per active vehicle with lat/lon, timestamp and age, speed, bearing and timetable delay, read from the same live store that powers the public bus map. Unlike the public feed this includes vehicles marked non-public and companies that opted out of the public map: it is your own data. Vehicles whose driver device is off shift (or silent for more than 10 minutes) are still listed, with live=false.
/api/v2/data/fleet/live
Fleet History API
Recorded GPS track of your own vehicles: every stored position point in a time window, in chronological order, with speed, bearing and accuracy. Filter to one vehicle or take the whole fleet. Window is limited to 31 days per call and 5000 points per response — page through longer periods by moving ?from= to the last returned timestamp.
/api/v2/data/fleet/history?vehicle_id=1&from=2026-08-01T00:00:00Z&to=2026-08-02T00:00:00Z&limit=1000
Plans
Explorer
- 1,000 calls/day on standard data APIs
- 200 calls/day on forecast & statistics APIs
- 2 requests per second
- Visible "Data by nakordoni.eu" link required
- Instant key after email verification
Student
- 5,000 calls/day on standard data APIs
- 1,000 calls/day on forecast & statistics APIs
- 5 requests per second
- Annual billing available — two months free
Pro
- 50,000 calls/day on standard data APIs
- 10,000 calls/day on forecast & statistics APIs
- 20 requests per second
- Annual billing available — two months free
Pro MAX
- 250,000 calls/day on standard data APIs
- 50,000 calls/day on forecast & statistics APIs
- 50 requests per second
- History data export included
- Advanced Wait Time API included
- Annual billing available — two months free
Transport and bus operators
Higher volumes, an annual contract, a purchase order or a conventional invoice? Tell us your expected volumes and we will agree limits and invoice you directly.
Paid plans are sold through Link, our payment provider, which acts as the merchant of record and handles VAT. Your statement will show LINK.COM* NAKORDONI API, and receipts are emailed to you by Link. Payment is unavailable in a few countries our provider cannot serve — we can invoice instead.
Quick start
curl "https://nakordoni.eu/api/v1/data/checkpoints" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Every response is a versioned JSON envelope with your remaining quota included — no surprises, no hidden billing. Authentication →
Works with the tools you already run
You do not need a development team to use this data. Plain JSON over HTTPS with a bearer key is something your spreadsheet, your BI tool and your accounting system can already read — the docs carry ready-made recipes for each.
Excel & Power BI
Power Query pulls live queues, forecasts, truck bans or fuel prices straight into a worksheet — no code, refreshed on a schedule. Two copy-paste M queries in the docs: one value, or a whole border in one table for a fleet dashboard.
BAS / BAF and 1C-family ERP
A scheduled job in BAS / BAF reads the API with HTTPConnection and writes the result straight into an information register — daily EU fuel prices for cost accounting, or live queue times for logistics. Working BSL sample in the docs.
Anything else that speaks HTTP
Python, PHP, JavaScript, Google Sheets, Zapier or Make, a TMS, a Telegram bot, an AI agent over our MCP server — one key, one URL pattern, the same response envelope everywhere.
Historical & seasonal datasets
Beyond the live API we offer per-checkpoint historical archives and seasonal analytics — holiday surges, summer and winter season patterns, year-over-year comparisons. Tell us what you need via a support ticket and we will prepare a custom export. History data export →
Our mobile apps
Free Android apps built for drivers and travellers on the road across Europe.
Kordon Online
Border queues at the EU border, in real time
Live truck & car queue waiting times at Ukraine–EU and neighbouring border crossings, checkpoint details, news and queue-change bell alerts.
Truck Bans
Truck driving bans across Europe — live
Sunday, holiday, night, German summer-Saturday and Ukraine heat bans — with exact times, weight limits, fines and exemptions. 14-day calendar, news, and a Germany ban map.
For bus companies
Passengers read and write reviews of bus carriers on nakordoni.eu. If that is your company, claim your listing — for free — and take care of your reputation:
Official responses to reviews
Reply publicly to any published review. Responses are moderated for a professional, respectful tone and shown as "Official company response" — with automatic translation, so passengers see your reply in their own language next to your original text.
Review alerts
Get an email the moment a new — especially critical — review of your company is published, and react before it shapes opinion. One-click translation of any review into your language.
Company gallery & logo
Upload photos of your buses, offices and team. Every image is processed automatically — faces blurred for privacy, content screened, bus licence plates recognized to link photos to your fleet roster — then human-reviewed before publishing.
Verified profile updates
Update contacts, website, social profiles and your logo. Changes are verified by our team before going live — that is what keeps every listing trustworthy.
NEW — Live bus map & fleet tracking (early access)
Put your buses on the nakordoni live map — the «Карта руху автобусів онлайн». Passengers see where their bus is right now and how late it runs, exactly like our live delay boards for trains and flights. No hardware to buy: our free driver app turns the driver's phone into a secure GPS beacon, or we connect the GPS/AVL system you already use.
Driver app, not trackers
Free iOS & Android app for drivers: one big Start/Stop shift button. Transmits only during an active shift, battery-friendly, buffers offline and syncs when back online.
Owner dashboard & apps
See your whole fleet live, get delay and no-signal alerts, manage drivers and devices, and export full movement history on demand — the data is yours.
Delay tracking passengers trust
Timetable vs. real position at every stop → on-time / +minutes late, published like airline and railway boards. Punctual fleets earn a visible punctuality score next to their verified reviews.
Widget & API for your site
A copy-paste «Where is my bus?» widget for your booking page, plus REST API, webhooks and GTFS-RT feeds — fewer support calls, more trust at checkout.
Works with your systems
Two-way integration: we ingest from Wialon-compatible AVL, GTFS/GTFS-RT or a simple REST push — and feed positions, ETAs and delays back into your dispatch or ticketing system.
Safe for drivers by design
Tracking runs only during a started shift and stops automatically after it — off duty means zero data sent. The public map shows the bus and route, never the driver. GDPR-compliant consent built in.
Connect one bus at no cost with the full feature set: live map, delay board, widget and API access. Add the rest of the fleet on individual per-bus terms once you have seen it work. Early-access partners are onboarded personally, usually within one day.
Owners ask us — quick answers
- Do I need to buy hardware? — No. The driver's phone is enough; an existing GPS/AVL system connects instead if you prefer.
- Who sees my buses? — You decide per vehicle: public live map, only your own widget and dashboard, or fully private.
- Who owns the data? — You do. Export the full history whenever you activate an export; we keep only anonymous aggregate statistics.
- Is it legal for my drivers? — Yes: built-in driver consent, tracking strictly on-shift, and the driver is never shown publicly.
- How fresh is the position? — Every 15–30 seconds while moving; offline gaps upload automatically once the bus is back in coverage.
- What does it cost after the free bus? — Simple per-bus pricing agreed individually in early access; no long-term lock-in, cancel anytime.
Who builds with our API
TruckBans.com ↗
Live European truck driving-ban status board, full calendar and free .ics feeds for 38 countries - built on the Truck Ban data API.
makinfo.mk ↗
Searchable database for company and public records in North Macedonia, with live border crossing wait times powered by the nakordoni.eu API.
yaknakordoni.com.ua ↗
Displays real-time queue information at Ukrainian border crossings with neighboring countries. Shows waiting times for cars, buses, and pedestrians at various checkpoints.
Kordon Online — Кордон онлайн ↗
Kordon Online — Кордон онлайн is an essential mobile app that provides real-time updates on border queues, live camera feeds, and accurate wait times at international checkpoints. Optimize your cross-border journeys, avoid long delays, and navigate customs efficiently with this user-friendly travel monitoring tool.
Kolejkanagranicy.pl ↗
KolejkaNaGranicy.pl to serwis internetowy udostępniający aktualne, na żywo, czasy oczekiwania na przekroczenie granic Polski (z Ukrainą, Niemcami, Białorusią i Litwą) oraz granic na popularnych trasach wakacyjnych na Bałkany (w tym przez Węgry, Serbię, Macedonię Północną, Bułgarię, Grecję, Chorwację, Czarnogórę i Albanię). Strona prezentuje szacunkowe dane dotyczące kolejek na wyjazd z kraju i wjazd do niego, wspierając podróżnych w wyborze najszybszej trasy.
Your project here
Building something with border, route or fuel data? Tell us via a support ticket — we feature live integrations.
Updated