Zum Hauptinhalt springen
GET
/
v1
/
validate
VAT-Validierungs-Endpunkt
curl --request GET \
  --url https://vat.cleariflow.com/v1/validate/
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Erste Schritte

​
Basis-URL

https://vat.cleariflow.com/v1/validate/

​
Validierungs-Endpunkt

Der validate-Endpunkt benötigt Ihren eindeutigen API-Schlüssel und die zu prüfende VAT-Nummer: 
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
Diese erfolgreiche Anfrage liefert umfassende Unternehmensinformationen zur validierten VAT-Nummer: 
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Anfrageparameter

​
api_key
String
erforderlich
Ihr eindeutiger API-Schlüssel. Beachten Sie, dass jeder Nutzer für jede Cleariflow-API eigene API-Schlüssel hat — Ihr VAT-Validierungs- und Steuersatz-API-Schlüssel funktioniert z. B. nicht für die IP-Geolokalisierungs-API.
​
vat_number
String
erforderlich
Die zu validierende VAT-Nummer.

​
Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben.
​
vat_number
String
Die zu validierende VAT-Nummer.
​
valid
Boolean
true, wenn die übermittelte VAT-Nummer gültig ist.
​
company
Object
Objekt mit Unternehmensinformationen.
​
company.name
String
Der Name des mit der VAT-Nummer verknüpften Unternehmens.
​
company.address
String
Die Adresse des mit der VAT-Nummer verknüpften Unternehmens.
​
country
Object
Objekt mit Länderinformationen.
​
country.code
String
Der zweistellige ISO-3166-1-alpha-2-Code des Landes, dem die VAT-Nummer zugeordnet ist.
​
country.name
String
Der Name des Landes, dem die VAT-Nummer zugeordnet ist.