Turkey,
in JSON.

Addresses, tax numbers, IBANs, e-invoices, holidays and exchange-rate history — the messy Turkish inputs your software receives, returned as clean structured data.

No account needed to try any endpoint on this page.
Deterministic endpoints answer from cache in single-digit milliseconds.
Every response carries a receipt: credits charged, cache status, duration.

Try an endpoint Read the spec

POST/v1/tr/address/parse

{
  "address": "Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"
}

no request sent yet

Press Run to call the live API from your browser.

6endpoints

—data points banked

—time series

—median response

Why this exists

The inputs are hostile

A Turkish address arrives as "Cd." or "Cad." or "Caddesi", with the flat number glued to the building number. Generic parsers drop half of it silently. This one tells you what it could not place.

History cannot be backfilled

The exchange-rate archive grows every business day and each point keeps its source URL and content hash. A competitor can read today’s bulletin too — nobody can produce last quarter’s.

You only pay for work

Repeated inputs come from cache and cost zero credits. If a response ever fails its own schema, the call is refunded automatically.

Endpointsexpand any row to see the parameters and call it live

Time Series1

/v1/series/history Time Series History 2 credits

Returns the accumulated history of public data series with change statistics and a source receipt for every point.

Currently ingesting the Turkish Central Bank daily FX bulletin (`tcmb.usd`, `tcmb.eur`, …), normalised to one unit so JPY-style 100-unit quotes stop biting. Leave `seriesId` empty to list the catalogue. `fillGaps` carries the last value across weekends and holidays; `includeEvidence` attaches the source URL and content hash for every point, so a value can still be defended years later.

Parameters

seriesId	string	Seri kimliği, ör. `tcmb.usd`. Boş bırakılırsa katalog döner.
from	string	Başlangıç tarihi (dahil).
to	string	Bitiş tarihi (dahil).
limit	integer	default 365
fillGaps	boolean	default false
includeEvidence	boolean	Her nokta için kaynak URL ve içerik özetini döndürür. default false

POST/v1/series/history

{}

no request sent yet

Press Run to call the live API from your browser.

Address1

/v1/tr/address/parse Turkish Address Parser deterministic 1 credit

Splits a free-form Turkish address into neighbourhood, street, building, floor, flat, district, province and postcode.

Handles the abbreviation chaos (Mah./Mh., Cd./Cad., Sk./Sok., No:12/5, K:3 D:7), cross-checks the province against the postcode, repairs misspelled district names against a dictionary, and returns a confidence score. Anything it could not place is listed in `unparsed` — nothing is dropped silently. Built for shipping, checkout and CRM systems that receive Turkish addresses typed by humans.

Parameters

address*	string	Serbest metin adres.
defaultProvince	string	Adreste il geçmiyorsa varsayılacak il.

POST/v1/tr/address/parse

{
  "address": "Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"
}

no request sent yet

Press Run to call the live API from your browser.

Calendar1

/v1/tr/business-days Turkish Business Days deterministic 1 credit

Adds business days or counts them between two dates, accounting for Turkish public and religious holidays including half-day eves.

Ramadan and Sacrifice feasts follow the Hijri calendar and cannot be derived reliably by formula, so announced dates are read from a table; years without an official announcement are returned with `confirmed:false` rather than guessed silently. For delivery promises, SLA clocks, payment terms and shipping estimates.

Parameters

start*	string	Başlangıç tarihi (YYYY-AA-GG).
addDays	integer	Bu kadar İŞ GÜNÜ ekle/çıkar.
end	string	Verilirse aradaki iş günü sayılır.
countHalfDaysAsWork	boolean	Arife yarım günleri iş günü sayılsın mı? default true

POST/v1/tr/business-days

{
  "start": "2026-03-16",
  "addDays": 10
}

no request sent yet

Press Run to call the live API from your browser.

Finance2

/v1/tr/invoice/parse Turkish e-Invoice (UBL-TR) Parser deterministic 3 credits

Turns a UBL-TR e-Invoice or e-Archive XML document into clean JSON: parties, line items, taxes and totals.

Works regardless of the namespace prefix the sender used (cbc:, cac:, ns0:), normalises single-line documents into arrays, and reports amount mismatches in `warnings` instead of returning quietly wrong totals. The job that costs accounting and expense software the most engineering time.

Parameters

xml*

string

UBL-TR e-Fatura / e-Arşiv XML içeriği.

POST/v1/tr/invoice/parse

{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\"\n         xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\"\n         xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\">\n  <cbc:UBLVersionID>2.1</cbc:UBLVersionID>\n  <cbc:ProfileID>TEMELFATURA</cbc:ProfileID>\n  <cbc:ID>ABC2026000000123</cbc:ID>\n  <cbc:UUID>3f2504e0-4f89-11d3-9a0c-0305e82c3301</cbc:UUID>\n  <cbc:IssueDate>2026-07-20</cbc:IssueDate>\n  <cbc:InvoiceTypeCode>SATIS</cbc:InvoiceTypeCode>\n  <cbc:DocumentCurrencyCode>TRY</cbc:DocumentCurrencyCode>\n  <cac:AccountingSupplierParty><cac:Party>\n    <cac:PartyIdentification><cbc:ID schemeID=\"VKN\">1234567890</cbc:ID></cac:PartyIdentification>\n    <cac:PartyName><cbc:Name>Örnek Yazılım A.Ş.</cbc:Name></cac:PartyName>\n    <cac:PostalAddress><cbc:StreetName>Moda Cad.</cbc:StreetName><cbc:BuildingNumber>12</cbc:BuildingNumber>\n      <cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName><cbc:CityName>İstanbul</cbc:CityName></cac:PostalAddress>\n    <cac:PartyTaxScheme><cac:TaxScheme><cbc:Name>Kadıköy</cbc:Name></cac:TaxScheme></cac:PartyTaxScheme>\n  </cac:Party></cac:AccountingSupplierParty>\n  <cac:AccountingCustomerParty><cac:Party>\n    <cac:PartyIdentification><cbc:ID schemeID=\"VKN\">9876543210</cbc:ID></cac:PartyIdentification>\n    <cac:PartyName><cbc:Name>Alıcı Ticaret Ltd. Şti.</cbc:Name></cac:PartyName>\n  </cac:Party></cac:AccountingCustomerParty>\n  <cac:TaxTotal><cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount>\n    <cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"TRY\">1000.00</cbc:TaxableAmount>\n      <cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount><cbc:Percent>20</cbc:Percent>\n      <cac:TaxCategory><cac:TaxScheme><cbc:Name>KDV</cbc:Name><cbc:TaxTypeCode>0015</cbc:TaxTypeCode></cac:TaxScheme></cac:TaxCategory>\n    </cac:TaxSubtotal></cac:TaxTotal>\n  <cac:LegalMonetaryTotal>\n    <cbc:LineExtensionAmount currencyID=\"TRY\">1000.00</cbc:LineExtensionAmount>\n    <cbc:TaxExclusiveAmount currencyID=\"TRY\">1000.00</cbc:TaxExclusiveAmount>\n    <cbc:TaxInclusiveAmount currencyID=\"TRY\">1200.00</cbc:TaxInclusiveAmount>\n    <cbc:PayableAmount currencyID=\"TRY\">1200.00</cbc:PayableAmount>\n  </cac:LegalMonetaryTotal>\n  <cac:InvoiceLine>\n    <cbc:ID>1</cbc:ID>\n    <cbc:InvoicedQuantity unitCode=\"C62\">10</cbc:InvoicedQuantity>\n    <cbc:LineExtensionAmount currencyID=\"TRY\">1000.00</cbc:LineExtensionAmount>\n    <cac:TaxTotal><cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount>\n      <cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"TRY\">1000.00</cbc:TaxableAmount>\n        <cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount><cbc:Percent>20</cbc:Percent>\n        <cac:TaxCategory><cac:TaxScheme><cbc:Name>KDV</cbc:Name><cbc:TaxTypeCode>0015</cbc:TaxTypeCode></cac:TaxScheme></cac:TaxCategory>\n      </cac:TaxSubtotal></cac:TaxTotal>\n    <cac:Item><cbc:Name>Yıllık Lisans</cbc:Name></cac:Item>\n    <cac:Price><cbc:PriceAmount currencyID=\"TRY\">100.00</cbc:PriceAmount></cac:Price>\n  </cac:InvoiceLine>\n</Invoice>"
}

no request sent yet

Press Run to call the live API from your browser.

/v1/tr/money/to-words Amount to Turkish Words deterministic 1 credit

Writes a monetary amount out in Turkish words, the way invoices, cheques and promissory notes require.

Applies the rules that trip up generic libraries: Turkish says "bin", never "bir bin"; the kuruş part is read separately; and both "1.234,56" and "1,234.56" are accepted and told apart automatically. A mandatory field on Turkish e-invoices, cheques and notes — with no off-the-shelf API until now.

Parameters

amount*	string \| number	Tutar. "1.234,56" ve 1234.56 biçimlerinin ikisi de kabul edilir.
currency	"TRY" \| "USD" \| "EUR" \| "GBP"	default "TRY"
style	"lower" \| "title" \| "upper"	Çıktı harf biçimi. default "lower"
wrapHash	boolean	default false

POST/v1/tr/money/to-words

{
  "amount": "1.234,56"
}

no request sent yet

Press Run to call the live API from your browser.

Validation1

/v1/tr/validate Turkish ID & Number Validation deterministic 1 credit

Validates Turkish national ID, tax number, IBAN, licence plate, IMEI and barcodes from one endpoint, with type auto-detection.

Goes past a yes/no: resolves the bank behind an IBAN, the province behind a licence plate and the GS1 country prefix behind a barcode. Pure local computation — no upstream service is called, so latency is microseconds and the answer never changes for the same input.

Parameters

value*	string	Doğrulanacak değer.
type	"auto" \| "tckn" \| "vkn" \| "iban" \| "plate" \| "imei" \| "gtin"	Belirtilmezse biçimden otomatik tespit edilir. default "auto"

POST/v1/tr/validate

{
  "value": "TR33 0006 1005 1978 6457 8413 26"
}

no request sent yet

Press Run to call the live API from your browser.

Pricingone key covers every endpoint

Free

credits: 2,000
Rate limit: 2/s

Starter

$19/mo

credits: 50,000
Rate limit: 10/s

most picked

Pro

$79/mo

credits: 300,000
Rate limit: 30/s

Scale

$299/mo

credits: 2,000,000
Rate limit: 100/s

Credits are consumed per call and cache hits are free. Requests without a key run on a narrow per-IP demo quota so you can evaluate before signing up.

Quickstart

cURL

curl -s https://api.temsor.com/v1/tr/address/parse \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"address":"Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/tr/address/parse", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"address":"Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/tr/address/parse",
    headers={"x-api-key": KEY},
    json={"address":"Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"})
data = r.json()["data"]

Turkey,in JSON.

Why this exists

The inputs are hostile

History cannot be backfilled

You only pay for work

Endpointsexpand any row to see the parameters and call it live

Time Series1

Parameters

Address1

Parameters

Calendar1

Parameters

Finance2

Parameters

Parameters

Validation1

Parameters

Pricingone key covers every endpoint

Quickstart

cURL

JavaScript

Python

Turkey,
in JSON.