TC kimlik no and VKN validation API
Check the check digits of a Turkish identity number (TC kimlik numarası, TCKN) or tax number (vergi kimlik numarası, VKN) before you save it.
What it does
Checks the check digits of a Turkish identity number (TCKN, 11 digits) or tax number (VKN, 10 digits).
- POST /v1/tr/identity/validate
- POST /v1/tr/tax-number/validate
Limits: Format only. No NVI or GİB registry lookup, so it cannot say the number belongs to a real person or company.
Use cases
- Catch typos in KYC and invoicing forms.
- Validate VKN before issuing an e-fatura.
- Clean up imported customer records.
Data sources and freshness
Published TCKN and VKN check-digit algorithms.
Algorithmic, no data to refresh.
Pricing
Every new account gets 100 free calls. Packs of 10,000 ($5), 100,000 ($15) and 250,000 calls ($29) never expire, or choose Unlimited for $39 a month. Only successful responses use a call. See pricing.
FAQ
Does it query NVİ or GİB?
No. It runs the checksum algorithms only and returns registry_checked: false. It cannot confirm that the number belongs to a real person or company.
Are the numbers stored?
No. ID and tax numbers in request bodies are never logged.