Kimlik ve Doğrulama

KDV numarası doğrulama API'si

Müşterilerinizin KDV numaralarını ödeme veya kayıt sırasında kontrol edin. AB ve Kuzey İrlanda numaraları AB KDV sicilinde, Norveç numaraları ise Norveç ticaret sicilinde canlı olarak kontrol edilir; ülkenin açıkladığı durumlarda kayıtlı ad ve adres de döner.

Dokümantasyonu görüntüle Ücretsiz aracı deneyin Tüm API'leri keşfedin

Uç Noktalar Aktif

GET /v1/vat/validate

Örnek istek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

Örnek yanıt 200 OK

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registe
...

Örnek istek GET /v1/vat/validate

Temel Özellikler 4

Sık sorulan sorular 4

HTTP durum kodları 200 / 400 / 401 / 402 / 429

Kategori Kimlik ve Doğrulama

Uç Noktalar 1

Temel Özellikler 4

Sık sorulan sorular 4

Bu şirketlerdeki kişiler tarafından kullanılıyor

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

10,000 Ücretsiz hak

Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.

Bu API neyi yayına almanıza yardımcı olur

Bu sayfayı üretim özeti olarak kullanın: endpointler, örnekler, yanıt yapısı ve DomScan’i ürününüze bağlamak için gereken workflow parçaları.

Ürün workflow’ları

Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.

Analist otomasyonu

Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.

Temiz JSON verisi

Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.

AI ve ops araçları

OpenAPI, SDK, Postman veya MCP üzerinden agent’ları, panoları, SOAR playbook’larını ve CRM’leri besleyin.

Entegrasyon workflow’u

İlk istekten tekrarlanabilir üretim kullanımına giden basit yol.

Bir kez doğrulayın

API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.

Örneklerle sorgulayın

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

İşletin ve izleyin

Retry, log ve uyarılar için durum kodlarını, kredi maliyetlerini ve yanıt alanlarını kullanın.

Geliştirici kiti

Bu sayfadan makine tarafından okunabilir dokümanlara, istek koleksiyonlarına, SDK’lere veya agent araçlarına geçin.

OpenAPI şeması

Client üretin veya her istek ve yanıt şeklini inceleyin.

Postman koleksiyonu

Manuel test ve ekip devri için hazır istekleri içe aktarın.

SDK’ler ve CLI

Boilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.

MCP entegrasyonu

Domain intelligence’ı AI agent’larına ve dahili asistan workflow’larına açın.

Parametre ve yanıt haritası

Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.

İstek parametreleri

Parametre

vatcountryrequester

Yanıt alanları

Örnek yanıt

vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered

Durum kapsamı

HTTP durum kodları

200400401402429

Uç Noktalar

GET /v1/vat/validate

Kredi: 1Kimlik Doğrulama: Kimlik dogrulama gerekli

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

10,000 Ücretsiz hak

Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.

Temel Özellikler

Canlı sicil kontrolleri

Geçerlilik, önbelleğe alınmış bir listeden veya yalnızca biçim kontrolünden değil, sorduğunuz anda resmî sicilden gelir.

Kontrolünüzün kanıtı

Ters tahsil faturalaması için kanıt olarak saklayabileceğiniz bir danışma numarası almak üzere kendi AB KDV numaranızı istekte bulunan olarak gönderin.

Önce biçim ve kontrol basamakları

Hatalı biçimli numaralar sicile başvurulmadan reddedilir ve kontrol basamakları desteklenen her ülke için raporlanır.

Bilinmiyor, asla geçersiz değil

Ulusal bir sicil kapalı veya meşgul olduğunda sonuç, nedeniyle birlikte bilinmiyor olur ve istek ücretlendirilmez.

Örnek istek

GET /v1/vat/validate?vat=NO923609016MVA bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

Örnek yanıt

200 OK json

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registered_since": "1989-07-01", "bankrupt": false }
}

Sık sorulan sorular

Hangi ülkeler kapsanıyor?

27 AB ülkesi ve Kuzey İrlanda ile Norveç canlı olarak kontrol edilir. UK, İsviçre ve Avustralya numaraları, bu sicillerin ücretsiz herkese açık bir kontrol hizmeti sunmaması nedeniyle biçim ve kontrol basamakları açısından denetlenir.

İşletme adı neden eksik?

Almanya ve İspanya gibi bazı ülkeler adları ve adresleri AB sicili üzerinden açıklamaz. Bu durumda sonuç name_disclosed değerini false yapar.

Bilinmiyor ne anlama geliyor?

Sicil yanıt veremedi: erişilemiyordu, meşguldü veya çok yavaştı. Daha sonra tekrar deneyin. Bilinmiyor sonuçlarının ücreti iade edilir.

Kaç krediye mal olur?

Kontrol başına bir kredi. Bilinmiyor olarak sonuçlanan kontroller ücretlendirilmez.

İlgili araçlar ve kaynaklar

HTTP durum kodları

İstemcinizin işlemesi gereken HTTP durum kodları şunlardır; böylece başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve üst kaynak hatalarını birbirinden ayırabilirsiniz.

OK 200

İstek başarılı

Hatalı İstek 400

Geçersiz parametreler

Yetkisiz 401

API anahtarı veya oturum eksik ya da geçersiz.

Ödeme Gerekli 402

Bu isteği çalıştırmak için yeterli krediniz yok.

Çok Fazla İstek 429

Hız sınırı aşıldı

KDV numarasını doğrulayın

Ücretsiz başlayın Dokümantasyonu görüntüle Ücretsiz aracı deneyin