One key.
Every endpoint.

A growing catalogue of small, precise APIs behind a single key and a single response envelope. Integrate once — every new capability is one more path, not another vendor to negotiate with.

In the catalogue today: Turkish address and e-invoice parsing, identifier validation, business-day maths, exchange-rate history. Shipping next: sanctions and PEP screening, IBAN and email verification.

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.

7endpoints

—data points banked

—time series

—median response

Why this exists

Built for hostile input

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

Compliance1

/v1/sanctions/screen Sanctions & PEP Screening 5 credits

Screens a name against the US OFAC, UN Security Council and EU consolidated sanctions lists with transliteration-aware fuzzy matching.

Cyrillic and Arabic names are transliterated, titles and corporate suffixes are stripped, and known spelling families are unified — "Abd al-Rahman", "Abdul Rahman" and "Abdulrahman" reach the same record. Every hit explains itself: which name matched, whether it was an alias the source flags as weak, and how the birth year and country compared. Supply `birthYear` whenever you have it; it removes most false positives. `asOf` screens against the lists as they stood on a past date, which is the question auditors actually ask — note that this is bounded by when our archive begins, reported in `coverage`.

Parameters

name*	string	Name to screen — person or organisation.
type	"any" \| "individual" \| "entity" \| "vessel" \| "aircraft"	Restrict to one subject type. Narrowing this removes most false positives. default "any"
birthYear	integer	Known birth year. The single strongest false-positive filter available.
country	string	Known country or nationality.
sources	"OFAC_SDN" \| "UN" \| "EU"[]	Defaults to all lists.
minScore	number	Score floor. 0.92+ reads as a match, 0.80+ as possible. default 0.75
limit	integer	default 10
asOf	string	Screen against the lists as they stood on this date. Limited by when our archive begins.

POST/v1/sanctions/screen

{
  "name": "Saddam Hussein"
}

no request sent yet

Press Run to call the live API from your browser.

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"]

One key.Every endpoint.

Why this exists

Built for hostile input

History cannot be backfilled

You only pay for work

Endpointsexpand any row to see the parameters and call it live

Compliance1

Parameters

Time Series1

Parameters

Address1

Parameters

Calendar1

Parameters

Finance2

Parameters

Parameters

Validation1

Parameters

Pricingone key covers every endpoint

Quickstart

cURL

JavaScript

Python

One key.
Every endpoint.