News submission and NakBus fleet are now in the partner dashboard
Connect your developer account to a Nakordoni Partners account with the same email and manage news and your bus fleet (NakDriver / NakManager) there, with team roles. Your API keys, endpoints and apps are unchanged, and the pages here keep working. Open Nakordoni Partners

← All endpoints

Exchange Office Cities API Online

Polish cities where we list currency exchange offices (kantors), with how many offices each has and how many currently publish rates. Use the city id with the other exchange products.

GET https://nakordoni.eu/api/v2/data/exchange-cities — quota class: cheap

ParameterDescription
langLanguage for city names (default en)

Response fields — inside the data object of the envelope. [] marks a list, so data.items[].name is the name field of each element. A field is null, absent or an empty list when we hold no value for it — never a placeholder.

FieldDescription
data.cities[].idCity id — the value the city parameter of the other exchange products takes.
data.cities[].nameCity name in the requested language, with country (always PL), lat and lon.
data.cities[].typeborder = a border town, hub = a large city.
data.cities[].officesListed exchange offices in the city.
data.cities[].offices_with_current_ratesOffices whose rates were updated in the last 72 hours.
data.quote_currencyCurrency every rate is quoted in (PLN).

Where the data comes from

Office listings and their rates are collected by Nakordoni from public information the exchange offices publish, checked for errors and shown next to the official National Bank of Poland (NBP) reference rate. Every rate carries the time it was valid; a rate older than 72 hours is marked is_current: false and never ranked.

Exchange offices can see what our reader collects, stop it, or correct or remove their listing at any time. Listings an owner asked us to remove disappear from these products too. NakordoniBot for exchange offices — information and opt-out

Each office row carries url — its page on nakordoni.eu. Link it where you show the data.

curl "https://nakordoni.eu/api/v2/data/exchange-cities?lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. Log in

Updated