Skip to main content
Menu

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.

Get your free API key Read the docs View on GitHub
We take data — and your privacy — seriously. One verified email is all we ask — used only for your key, quota notices and support replies. No marketing lists, no card on file, no tracking SDKs. Free Explorer keys are issued instantly; paid plans start only after you have tried the data and we have talked.

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 soon

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?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 soon

Plans

PREPAID

Pay As You Grow

from €0.70 / 1,000 calls
  • 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
Try free first, then upgrade

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.

See the integration recipes

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.

Request a dataset

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.

Claim your company

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.