Guides

Working solutions to problems that keep showing up when you deal with Turkish and EU business data. Every example runs against the live API without a key.

Parsing Turkish addresses: mahalle, sokak, kapı no, daire

Turkish addresses are written free-form and read right-to-left in scope. Here is why western parsers fail on them and how to get province, district, street and door number reliably.

Historical fuel prices in Türkiye: what diesel cost on any past date

Today’s pump price is on a public page; the archive is not. How to get the petrol or diesel price in force in any Turkish province on any date back to 2009.

Issuing a Turkish e-Invoice (UBL-TR) from your own software

What a UBL-TR document must contain, why integrators reject valid-looking invoices, and how to produce one from JSON without reading the 400-page spec.

How to validate a Turkish IBAN (and why mod-97 alone is not enough)

Turkish IBANs are 26 characters and pass mod-97 even when the bank code is nonsense. Here is what to check, in what order, with runnable code.