TR Vergi-No Validator API — VKN & TCKN

Pricing

Rating

Developer

Actor stats

Categories

Share

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

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ı

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.