> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VAT-Validierungs-Endpunkt

> Der `validate`-Endpunkt verarbeitet VAT-Nummern, prüft deren Echtheit und liefert umfassende Unternehmensinformationen einschließlich Firmendetails, Adresse und Länderregistrierung.

## 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:

<ResponseExample>
  ```json theme={"system"}
  {
      "company": {
          "address": "8 RUE DE LONDRES\n75009 PARIS",
          "name": "EURL GOOGLE FRANCE"
      },
      "country": {
          "code": "FR",
          "name": "France"
      },
      "valid": true,
      "vat_number": "FR64443061841"
  }
  ```
</ResponseExample>

### Anfrageparameter

<ParamField query="api_key" type="String" required>
  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.
</ParamField>

<ParamField query="vat_number" type="String" required>
  Die zu validierende VAT-Nummer.
</ParamField>

### Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen [JSON-Format](https://www.json.org/json-en.html) zurückgegeben.

<ResponseField name="vat_number" type="String">
  Die zu validierende VAT-Nummer.
</ResponseField>

<ResponseField name="valid" type="Boolean">
  `true`, wenn die übermittelte VAT-Nummer gültig ist.
</ResponseField>

<ResponseField name="company" type="Object">
  Objekt mit Unternehmensinformationen.
</ResponseField>

<ResponseField name="company.name" type="String">
  Der Name des mit der VAT-Nummer verknüpften Unternehmens.
</ResponseField>

<ResponseField name="company.address" type="String">
  Die Adresse des mit der VAT-Nummer verknüpften Unternehmens.
</ResponseField>

<ResponseField name="country" type="Object">
  Objekt mit Länderinformationen.
</ResponseField>

<ResponseField name="country.code" type="String">
  Der zweistellige ISO-3166-1-alpha-2-Code des Landes, dem die VAT-Nummer zugeordnet ist.
</ResponseField>

<ResponseField name="country.name" type="String">
  Der Name des Landes, dem die VAT-Nummer zugeordnet ist.
</ResponseField>