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 queue status and data freshness for up to 20 checkpoints in a single request. Quota counts as ⌈(N PPIDs × sub-products) / 2⌉ — 50% cheaper than equivalent individual calls. Use include=queue,update-info to get both datasets at once.
/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
Average petrol/diesel/LPG prices across EU countries plus nearest stations, aggregated from official national sources.
/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.
/api/v1/data/pois?type=parking&lat=50.7&lon=23.9&radius=50
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 by country and date, including seasonal and holiday bans.
/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 API
Current conditions and road warnings at border checkpoints. (Coming soon)
Coming soonBus 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?country=UA&severity=major
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
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
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.
/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 soonPlans
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
Pay As You Grow
- 50,000 calls/day on standard data APIs
- 10,000 calls/day on forecast & statistics APIs
- 20 requests per second
- Historical & seasonal dataset exports on request
- Available after you have tried the Explorer plan — request it from your dashboard and we will set you up personally
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.
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.
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.
Who builds with our 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.
Your project here
Building something with border, route or fuel data? Tell us via a support ticket — we feature live integrations.