Tutti i valichi su un confine dato + tipo di veicolo in una sola chiamata. Supporta destinazione singola, elenco separato da virgole o "all". Risultati ordinati per lunghezza della coda.
GEThttps://nakordoni.eu/api/v1/data/border/1/2/4
— classe di quota: heavy
Parametro
Descrizione
origin
Codice paese di origine (segmento URL): 1=Ucraina, 2=Polonia, 3=Slovacchia, 4=Ungheria, 5=Romania…
destination
Destinazione: un codice, un elenco separato da virgole oppure "all" per tutti i vicini — l'elenco e "all" sono deprecati; v4 accetta un solo paese per chiamata
crossing_type
Tipo veicolo: 4=auto, 5=auto (esenzione), 6=autobus, 7=pedoni, 8=autocarro <7.5t, 9=autocarro
lang
Lingua per i nomi dei valichi nella risposta (predefinito en)
Campi della risposta— all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
Campo
Descrizione
data.origin
Numeric country code the path asked for, plus origin_name in the requested language.
data.destinations
Numeric country codes the call expanded to, plus destination_names.
data.crossing_type
Vehicle type of every row, plus crossing_type_label.
data.checkpoints[].ppid
Checkpoint ID.
data.checkpoints[].name
Checkpoint name in the requested language.
data.checkpoints[].border
Numeric country code of the neighbour this crossing leads to, plus border_name.
data.checkpoints[].queue
Vehicles counted in the queue right now.
data.checkpoints[].wait_min
Estimated wait in minutes; null where the crossing has no wait signal.
data.checkpoints[].wait_status
Plain-language band for the wait (e.g. free_flow, moderate, heavy).
data.checkpoints[].trend_percent
Change against the recent baseline, with trend_direction (up | down | flat).
data.checkpoints[].updated_at
When this reading was taken, plus age_min — how old it is now.
data.checkpoints[].source_url
Public page for the checkpoint, for the attribution link.
data.count
Number of checkpoints returned; generated_at is when the set was assembled.
Cosa cambia in questa versione:
Directional: path order is the travel direction (/1/2/6 = UA→PL, /2/1/6 = PL→UA). Adds a per-checkpoint direction{from,to} + stale flag, and a ?max_age_min= freshness filter. v1 returns both sides of the border regardless of order.
Directional border queues. The path order is the travel direction, matched against each checkpoint's own orientation: /1/2/6 = buses UA→PL (Ukrainian-side crossings), /2/1/6 = buses PL→UA (Polish-side crossings) — swap origin/destination for the opposite direction. Each checkpoint also carries a "stale" flag, and ?max_age_min=N returns only recently-updated crossings. Everything else matches v1.
GEThttps://nakordoni.eu/api/v2/data/border/1/2/6
— classe di quota: heavy
Parametro
Descrizione
origin
Codice del paese di origine (segmento del percorso URL): 1=Ucraina, 2=Polonia, 3=Slovacchia, 4=Ungheria, 5=Romania, 6=Moldova, 7=Bielorussia, 8=Lituania, 9=Lettonia, 11=Slovenia, 12=Bulgaria, 13=Serbia, 14=Turchia, 15=Macedonia del Nord, 16=Croazia, 17=Bosnia ed Erzegovina, 18=Germania, 19=Grecia, 20=Italia, 21=Albania, 22=Montenegro, 23=Kosovo.
destination
Destinazione (segmento del percorso URL): un singolo codice paese, un elenco separato da virgole (es. 2,3,5) o «all». L'ordine è direzionale — invertite origine e destinazione per il senso di marcia opposto. Sia l'elenco sia «all» sono deprecati e smettono di funzionare il 2026-10-06 — /api/v4/ accetta esattamente una destinazione per chiamata.
crossing_type
Tipo di veicolo (segmento del percorso URL): 4=Automobile, 5=Automobile. Tax Free, 6=Autobus, 7=Pedone, 8=Trasporto merci, 9=Trasporto merci fino a 7,5 tonnellate. Nell'elenco dei valichi esistono altri id (traghetto 10-13, merci fino a 3,5 t 14, ferrovia 15); questo prodotto risponde 400 per essi.
lang
Lingua dei nomi dei valichi nella risposta (predefinito en)
max_age_min
Filtro di freschezza facoltativo (query string): restituisce solo i valichi la cui lettura in tempo reale è più recente di N minuti (scarta anche quelli senza lettura). Ogni valico porta un booleano «stale» (più vecchio di 240 min, o di max_age_min se impostato).
Campi della risposta— all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
Campo
Descrizione
data.origin
Numeric country code the path asked for, plus origin_name in the requested language.
data.destinations
Numeric country codes the call expanded to, plus destination_names.
data.crossing_type
Vehicle type of every row, plus crossing_type_label.
data.checkpoints[].ppid
Checkpoint ID.
data.checkpoints[].name
Checkpoint name in the requested language.
data.checkpoints[].border
Numeric country code of the neighbour this crossing leads to, plus border_name.
data.checkpoints[].queue
Vehicles counted in the queue right now.
data.checkpoints[].wait_min
Estimated wait in minutes; null where the crossing has no wait signal.
data.checkpoints[].wait_status
Plain-language band for the wait (e.g. free_flow, moderate, heavy).
data.checkpoints[].trend_percent
Change against the recent baseline, with trend_direction (up | down | flat).
data.checkpoints[].updated_at
When this reading was taken, plus age_min — how old it is now.
data.checkpoints[].source_url
Public page for the checkpoint, for the attribution link.
data.count
Number of checkpoints returned; generated_at is when the set was assembled.
Cosa cambia in questa versione:
One destination per call — destination=all removed (400 lists the expansion) and the comma-separated destination list is not accepted either (400 too_many_destinations); freight merged into one truck code (9, with 8 as an alias) so a truck query returns every truck lane; per-row crossing_type added. Everything else is v2: directional path order, direction{from,to}, stale, ?max_age_min=. v3 carried these same changes for one day and was retired into v4 on 2026-09-07.
Directional border queues, as v2, with two removals. ONE DESTINATION PER CALL: v4 takes a single destination country — neither "all" nor a comma-separated list is accepted, and both answer 400. Markets are licensed per country (Developer API Terms, section 7), and any request covering several countries at once returns data an account may not hold, which is the one request shape the market gate cannot police. Query several countries by sending several calls — there is no batching product for borders (`multi` is per-checkpoint, up to 5 PPIDs, and has no concept of a border). Freight is one code: 9 returns every truck lane on the border (v1/v2 split it into 8 and 9, so asking for 9 on UA-PL returned 21 crossings out of 70), and 8 is accepted as an alias of 9. Each row carries its own crossing_type so a merged answer stays inspectable.
GEThttps://nakordoni.eu/api/v4/data/border/1/2/9
— classe di quota: heavy
Parametro
Descrizione
origin
Codice del paese di origine (segmento del percorso URL): 1=Ucraina, 2=Polonia, 3=Slovacchia, 4=Ungheria, 5=Romania, 6=Moldova, 7=Bielorussia, 8=Lituania, 9=Lettonia, 11=Slovenia, 12=Bulgaria, 13=Serbia, 14=Turchia, 15=Macedonia del Nord, 16=Croazia, 17=Bosnia ed Erzegovina, 18=Germania, 19=Grecia, 20=Italia, 21=Albania, 22=Montenegro, 23=Kosovo.
destination
Destinazione: ESATTAMENTE UN codice paese. Un elenco separato da virgole non è accettato (400) e "all" non è accettato (400). Per più destinazioni, inviare una chiamata per paese — non esiste un prodotto aggregato per le frontiere.
crossing_type
Tipo di veicolo (segmento del percorso URL): 4=Automobile, 5=Automobile. Tax Free, 6=Autobus, 7=Pedone, 9=Trasporto merci. 8 è accettato come alias di 9. I valichi con traghetto (10-13) e ferroviari (15) esistono nell'elenco, ma questo prodotto risponde 400 per essi.
lang
Lingua dei nomi dei valichi nella risposta (predefinito en)
max_age_min
Filtro di freschezza facoltativo (query string): restituisce solo i valichi la cui lettura in tempo reale è più recente di N minuti (scarta anche quelli senza lettura). Ogni valico porta un booleano «stale».
Campi della risposta— all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
Campo
Descrizione
data.checkpoints[].crossing_type
The crossing's own type — 8 or 9 inside a merged truck answer.
data.crossing_type_requested
Set only when the request used 8 and it was folded into 9; null otherwise.
