TR Vergi-No Validator API — VKN & TCKN

Türkiye VKN (Vergi Kimlik Numarası, 10 hane) ve TCKN (T.C. Kimlik Numarası, 11 hane) checksum doğrulama servisi. ISO standart kontrol algoritmaları, milisaniyede yanıt. Apify Standby modunda gerçek-zamanlı HTTP API.

KVKK-safe: Yalnızca matematiksel checksum doğrulaması yapılır. Kişi/mükellef sorgusu (lookup) YOKTUR; girilen değer loglanmaz, saklanmaz, yanıtta echo edilmez. Yanıt sadece isValid döndürür.

Endpoint'ler

Method	Path	Açıklama
POST	/vkn	VKN (10 hane) doğrula
POST	/tckn	TCKN (11 hane) doğrula

Standby Actor — her isteğe Apify API token'ı gerekir (header Authorization: Bearer <TOKEN> veya ?token=).

VKN — cURL

curl -X POST "https://caulleonard--vergi-no-validator.apify.actor/vkn" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"vkn": "1234567890"}'

TCKN — cURL

curl -X POST "https://caulleonard--vergi-no-validator.apify.actor/tckn" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"tckn": "12345678950"}'

Python

import requests

base = "https://caulleonard--vergi-no-validator.apify.actor"
h = {"Authorization": "Bearer <APIFY_TOKEN>"}

print(requests.post(f"{base}/vkn",  json={"vkn":  "1234567890"},  headers=h).json())
print(requests.post(f"{base}/tckn", json={"tckn": "12345678950"}, headers=h).json())

Yanıt

{ "isValid": true,  "type": "VKN",  "errors": [] }

{ "isValid": false, "type": "TCKN", "errors": ["bad_checksum"] }

Yanıt yalnızca isValid, type, errors içerir — girilen numara geri döndürülmez (KVKK veri minimizasyonu).

Hata kodları

Kod	Anlam
empty	Boş girdi
non_numeric	Rakam dışı karakter
invalid_length	VKN≠10 / TCKN≠11 hane
leading_zero	TCKN ilk hane 0 olamaz
bad_checksum	Kontrol hanesi tutmuyor

Fiyatlandırma

Pay-per-event: $0.001 / istek (api-call). Hem VKN hem TCKN aynı fiyat. Platform kullanım maliyeti kullanıcıya aittir (Standby standardı).

Notlar

• VKN tüzel/işletme, TCKN gerçek kişi numarasıdır; bu servis ikisini de yalnızca algoritmik olarak doğrular.
• Checksum geçerli olması numaranın gerçekten kayıtlı/aktif olduğunu göstermez — yalnızca format + kontrol hanesi doğruluğunu doğrular.