Всички ГКПП на дадена граница за един тип превозно средство в едно извикване. Поддържа единична дестинация, списък с запетаи или "all". Резултатите са сортирани по опашка.
GEThttps://nakordoni.eu/api/v1/data/border/1/2/4
— клас квота: heavy
Параметър
Описание
origin
Код на страната на произход (URL сегмент): 1=Украйна, 2=Полша, 3=Словакия, 4=Унгария, 5=Румъния…
destination
Направление: един код, списък, разделен със запетая, или "all" за всички съседи — списъкът и "all" са остарели; v4 приема по една държава на заявка
crossing_type
Тип МПС: 4=кола, 5=кола (безмитна), 6=автобус, 7=пешеходци, 8=товарен <7.5т, 9=товарен
lang
Език за имената на ГКПП в отговора (по подразбиране en)
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
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.
Какво е различно в тази версия:
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
— клас квота: heavy
Параметър
Описание
origin
Код на държавата на тръгване (сегмент от пътя в URL): 1=Украйна, 2=Полша, 3=Словакия, 4=Унгария, 5=Румъния, 6=Молдова, 7=Беларус, 8=Литва, 9=Латвия, 11=Словения, 12=България, 13=Сърбия, 14=Турция, 15=Северна Македония, 16=Хърватия, 17=Босна и Херцеговина, 18=Германия, 19=Гърция, 20=Италия, 21=Албания, 22=Черна гора, 23=Косово.
destination
Направление (сегмент от пътя в URL): единичен код на държава, списък, разделен със запетаи (напр. 2,3,5), или „all“. Редът е насочен — разменете отправната и крайната държава за обратната посока на пътуване. И списъкът, и „all“ са остарели и спират да работят на 2026-10-06 — /api/v4/ приема точно едно направление на заявка.
crossing_type
Тип превозно средство (сегмент от пътя в URL): 4=Лек автомобил, 5=Лек автомобил. Tax Free, 6=Автобус, 7=Пешеходец, 8=Товарен транспорт, 9=Товарен транспорт до 7,5 тона. В указателя на граничните пунктове съществуват и други идентификатори (ферибот 10-13, товарен до 3,5 т 14, железница 15); този продукт отговаря с 400 за тях.
lang
Език на имената на граничните пунктове в отговора (по подразбиране en)
max_age_min
Незадължителен филтър за актуалност (query string): връща само пунктове, чието живо отчитане е по-ново от N минути (отпадат и тези без отчитане). Всеки пункт носи булево поле „stale“ (по-старо от 240 мин или от max_age_min, ако е зададено).
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
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.
Какво е различно в тази версия:
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
— клас квота: heavy
Параметър
Описание
origin
Код на държавата на тръгване (сегмент от пътя в URL): 1=Украйна, 2=Полша, 3=Словакия, 4=Унгария, 5=Румъния, 6=Молдова, 7=Беларус, 8=Литва, 9=Латвия, 11=Словения, 12=България, 13=Сърбия, 14=Турция, 15=Северна Македония, 16=Хърватия, 17=Босна и Херцеговина, 18=Германия, 19=Гърция, 20=Италия, 21=Албания, 22=Черна гора, 23=Косово.
destination
Направление: ТОЧНО ЕДИН код на държава. Списък, разделен със запетая, не се приема (400), "all" не се приема (400). За няколко направления изпращайте по една заявка на държава — няма групов продукт за граници.
crossing_type
Тип превозно средство (сегмент от пътя в URL): 4=Лек автомобил, 5=Лек автомобил. Tax Free, 6=Автобус, 7=Пешеходец, 9=Товарен транспорт. 8 се приема като синоним на 9. Фериботните (10-13) и железопътните (15) пунктове съществуват в указателя, но този продукт отговаря с 400 за тях.
lang
Език на имената на граничните пунктове в отговора (по подразбиране en)
max_age_min
Незадължителен филтър за актуалност (query string): връща само пунктове, чието живо отчитане е по-ново от N минути (отпадат и тези без отчитане). Всеки пункт носи булево поле „stale“.
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
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.
