Identiteit & verificatie

API voor validatie van btw-nummers

Controleer de btw-nummers van uw klanten bij het afrekenen of de onboarding. Europese en Noord-Ierse nummers worden live gecontroleerd in het Europese btw-register en Noorse nummers in het Noorse bedrijvenregister, met de geregistreerde naam en het adres als het land die vrijgeeft.

Categorie Identiteit & verificatie
Endpoints 1
Belangrijkste functies 4
Veelgestelde vragen 4

Gebruikt door mensen bij deze bedrijven

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Actief Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

10,000 Gratis tegoed

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Wat deze API je helpt bouwen

Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.

Productworkflows

Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.

Analistautomatisering

Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.

Schone JSON-data

Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.

AI- en ops-tools

Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.

Integratieworkflow

Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.

1
Eenmalig authenticeren

Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.

2
Query met voorbeelden

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

3
Opereren en monitoren

Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.

Developerkit

Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.

Parameter- en responskaart

Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.

Requestparameters

Parameter

vatcountryrequester
Responsvelden

Voorbeeldantwoord

vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered
Statusdekking

HTTP-statuscodes

200400401402429

Endpoints

GET /v1/vat/validate
Tegoeden: 1Authenticatie: Authenticatie vereist

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Actief Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

10,000 Gratis tegoed

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Belangrijkste functies

Live registercontroles

De geldigheid komt op het moment van uw vraag uit het officiële register, niet uit een gecachete lijst of alleen een formaatcontrole.

Bewijs van uw controle

Stuur uw eigen Europese btw-nummer mee als requester om een consultatienummer te ontvangen dat u kunt bewaren als bewijs voor facturering met verlegde btw.

Eerst formaat en controlecijfers

Onjuist opgebouwde nummers worden afgewezen zonder registeraanroep, en de controlecijfers worden voor elk ondersteund land gemeld.

Onbekend, nooit ongeldig

Als een nationaal register offline staat ofwel druk bezet blijkt, meldt het resultaat onbekend met de reden, en wordt het verzoek niet in rekening gebracht.

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Veelgestelde vragen

Welke landen worden gedekt?

De 27 EU-landen en Noord-Ierland worden live gecontroleerd, evenals Noorwegen. Britse, Zwitserse en Australische nummers worden op formaat en controlecijfers gecontroleerd, omdat die registers geen gratis openbare controle bieden.

Waarom ontbreekt de bedrijfsnaam?

Sommige landen, zoals Duitsland en Spanje, geven namen en adressen niet vrij via het Europese register. Het resultaat zet dan name_disclosed op false.

Wat betekent onbekend?

Het register kon geen antwoord geven: het was niet beschikbaar, druk of te traag. Probeer het later opnieuw. Onbekende resultaten worden terugbetaald.

Hoeveel credits kost het?

Eén credit per controle. Controles die als onbekend eindigen worden niet in rekening gebracht.

Gerelateerde hulpprogramma's en bronnen

HTTP-statuscodes

Dit zijn de HTTP-statuscodes die je moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.

OK 200

Aanvraag geslaagd

Ongeldig verzoek 400

Ongeldige parameters

Niet geautoriseerd 401

Ontbrekende dan wel ongeldige API-sleutel of sessie.

Betaling vereist 402

Niet genoeg credits om deze aanvraag uit te voeren.

Te veel verzoeken 429

Snelheidslimiet overschreden