Numarayı gönderin
VKN veya TCKN değerini identity alanına ekleyin.
TÜRKİYE İÇİN MÜKELLEF SORGU
Mükellef sorgulama,
projenizin içinden.
Vergi kimlik numarasıyla sorgulayın; mükellef bilgilerini JSON olarak alın.
İSTEK ÖRNEĞİ
GETSunucunuzdan güvenli sorgu
const apiKey = "sk_live_0124...";
const identity = "10_HANELI_VKN";
const url = new URL("https://vkn.apionix.com/sorgula/" + encodeURIComponent(identity));
const response = await fetch(url, {
method: "GET",
headers: { "X-API-Key": apiKey }
});
const result = await response.json(); API anahtarınızı sunucuda saklayın; tarayıcı koduna veya URL’ye eklemeyin.
CANLI SORGU
Bir numarayla hemen deneyin.
10 haneli VKN veya 11 haneli TCKN girin. Sorgu yanıtını hemen görüntüleyin.
Vergi kimlik bilgisi
Numarayı girerek sorgulamayı başlatın.
JSON yanıtı
Sorgu yanıtı burada görüntülenecek.
API REFERANSI
Yanıt şeması
İstek adresi, kimlik doğrulama başlığı ve örnek JSON yanıtı.
GET
/sorgula/{identity}200 OK{
"statusCode": 200,
"success": true,
"data": {
"no": "10_HANELI_VKN",
"sahis": false,
"mukellefTipi": "ŞİRKET",
"unvan": "ÖRNEK ŞİRKET A.Ş.",
"adi": "",
"soyadi": "",
"vergiDairesi": "ÖRNEK VERGİ DAİRESİ",
"tur": "OZEL",
"ilkKayit": "2014-01-01T09:02:16.000Z",
"efatura": true,
"eirsaliye": true
}
}200 Sorgu başarılı
429 İstek limiti aşıldı
502 Veri kaynağı yanıt vermedi
503 Servis geçici olarak kullanılamıyor
ENTEGRASYON
Üç adımda kullanmaya başlayın.
İstek gönderin, yanıtı alın ve projenizde kullanın.
Sorguyu başlatın
Numarayı /sorgula/{identity} adresindeki kimlik alanına ekleyin.
Yanıtı kullanın
Dönen alanları uygulamanızda değerlendirin.
FİYATLANDIRMA
Projenize uygun planı seçin.
Free planla başlayın, kullanım ihtiyacınız büyüdükçe Plus veya Kurumsal plana geçin.
ÜCRETSİZ PLAN
Free
₺0Süresiz
- Her gün 10 sorgu ücretsiz
- Rate limit uygulanır
- 5 dakikada en fazla 10 istek
ÜCRETLİ PLAN
Plus
₺599/ 12 ay
- Günlük sorgu sınırı yok
- Rate limit uygulanır
- 5 dakikada en fazla 10 istek
KURUMSAL PLAN
Kurumsal
Teklif alın
- Rate limit uygulanmaz
- Öncelikli teknik destek
- Kurulum ve entegrasyon eğitimi
SERVİS HAKKINDA
TÜRKİYE İÇİN MÜKELLEF SORGU
VKN ve TCKN Sorgulama Servisi, projelere kolayca eklenebilen bir web servisidir. 10 haneli Vergi Kimlik Numarası (VKN) veya 11 haneli T.C. Kimlik Numarası (TCKN) ile GET isteği gönderilir. Kayıtta bulunan mükellef türü, şirket unvanı ya da ad ve soyad bilgileri ile vergi dairesi, JSON yanıtı olarak iletilir. Böylece vergi kimlik bilgisi sorgulamasını uygulamanızla kolayca bütünleştirebilirsiniz.