Tożsamość i weryfikacja

API do walidacji numerów VAT

Sprawdzaj numery VAT swoich klientów przy finalizacji zamówienia lub rejestracji. Numery z UE i Irlandii Północnej są sprawdzane na żywo w unijnym rejestrze VAT, a numery norweskie w norweskim rejestrze przedsiębiorstw, wraz z zarejestrowaną nazwą i adresem, jeśli dany kraj je ujawnia.

Zobacz dokumentację Wypróbuj bezpłatne narzędzie Poznaj wszystkie API

Punkty końcowe Aktywny

GET /v1/vat/validate

Przykładowe żądanie

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

Przykładowa odpowiedź 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
...

Przykładowe żądanie GET /v1/vat/validate

Kluczowe funkcje 4

Często zadawane pytania 4

Kody statusu HTTP 200 / 400 / 401 / 402 / 429

Kategoria Tożsamość i weryfikacja

Punkty końcowe 1

Kluczowe funkcje 4

Często zadawane pytania 4

Używany przez ludzi w tych firmach

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

10,000 Darmowy limit

Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.

Co ta API pomaga wdrożyć

Użyj tej strony jako briefu produkcyjnego: endpointy, przykłady, kształt odpowiedzi i elementy workflow potrzebne do podłączenia DomScan do produktu.

Workflow produktu

Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.

Automatyzacja analityków

Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.

Czyste dane JSON

Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.

AI i narzędzia ops

Zasilaj agentów, dashboardy, playbooki SOAR i CRMy przez OpenAPI, SDK, Postman lub MCP.

Workflow integracji

Prosta ścieżka od pierwszego requestu do powtarzalnego użycia produkcyjnego.

Uwierzytelnij raz

Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.

Odpytuj z przykładami

Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.

Operuj i monitoruj

Używaj kodów statusu, kosztów kredytów i pól odpowiedzi do retries, logów i alertów.

Zestaw developerski

Przejdź z tej strony do dokumentacji machine-readable, kolekcji requestów, SDK lub narzędzi agentowych.

Schemat OpenAPI

Generuj klientów lub sprawdzaj każdy kształt requestu i odpowiedzi.

Kolekcja Postman

Importuj gotowe requesty do testów manualnych i przekazania zespołowi.

SDK i CLI

Używaj utrzymywanych pakietów i workflow command-line zamiast pisać boilerplate.

Integracja MCP

Udostępniaj domain intelligence agentom AI i wewnętrznym asystentom.

Mapa parametrów i odpowiedzi

Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.

Parametry requestu

Parametr

vatcountryrequester

Pola odpowiedzi

Przykładowa odpowiedź

vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered

Zakres statusów

Kody statusu HTTP

200400401402429

Punkty końcowe

GET /v1/vat/validate

Kredyty: 1Uwierzytelnianie: Uwierzytelnienie required

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

10,000 Darmowy limit

Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.

Kluczowe funkcje

Sprawdzanie w rejestrze na żywo

Ważność pochodzi z oficjalnego rejestru w chwili zapytania, a nie z listy w pamięci podręcznej ani samego sprawdzenia formatu.

Dowód Twojego sprawdzenia

Wyślij własny unijny numer VAT jako requester, aby otrzymać numer konsultacji, który możesz zachować jako dowód przy fakturowaniu z odwrotnym obciążeniem.

Najpierw format i cyfry kontrolne

Błędnie zbudowane numery są odrzucane bez wywołania rejestru, a cyfry kontrolne są raportowane dla każdego obsługiwanego kraju.

Nieznany, nigdy nieprawidłowy

Gdy krajowy rejestr nie działa lub jest przeciążony, wynik to nieznany wraz z przyczyną, a żądanie nie jest rozliczane.

Przykładowe żądanie

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

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

Przykładowa odpowiedź

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 }
}

Często zadawane pytania

Jakie kraje są objęte?

27 krajów UE oraz Irlandia Północna są sprawdzane na żywo, podobnie jak Norwegia. Numery z Wielkiej Brytanii, Szwajcarii i Australii są sprawdzane pod kątem formatu i cyfr kontrolnych, ponieważ tamtejsze rejestry nie oferują darmowego publicznego sprawdzania.

Dlaczego brakuje nazwy firmy?

Niektóre kraje, takie jak Niemcy i Hiszpania, nie ujawniają nazw ani adresów przez unijny rejestr. Wynik ustawia wtedy name_disclosed na false.

Co oznacza nieznany?

Rejestr nie mógł udzielić odpowiedzi: był niedostępny, przeciążony lub zbyt wolny. Spróbuj ponownie później. Wyniki nieznane są zwracane na konto.

Ile kosztuje w kredytach?

Jeden kredyt za sprawdzenie. Sprawdzenia kończące się wynikiem nieznanym nie są rozliczane.

Narzędzia pokrewne i zasoby

Kody statusu HTTP

Oto kody statusu HTTP, które należy obsługiwać, aby odróżnić udane odpowiedzi, problemy z uwierzytelnianiem, kredyty, limity żądań, brakujące dane i błędy usług nadrzędnych.

OK 200

Żądanie zakończone pomyślnie

Nieprawidłowe żądanie 400

Nieprawidłowe parametry

Nieautoryzowany 401

Brakuje klucza API lub sesji albo są one nieprawidłowe.

Wymagana płatność 402

Za mało kredytów, aby wykonać to żądanie.

Zbyt wiele żądań 429

Przekroczono limit żądań

Zwaliduj numer VAT

Zacznij za darmo Zobacz dokumentację Wypróbuj bezpłatne narzędzie