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

# Endpoint de validación de IVA

> El endpoint `validate` procesa envíos de números de IVA para verificar su autenticidad y recuperar información empresarial completa, incluidos detalles de la empresa, dirección y datos de registro del país.

## Primeros pasos

### URL base

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

### Endpoint de validación

El endpoint `validate` requiere su clave API única y el número de IVA que desea verificar:

```
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
```

Esta solicitud exitosa devuelve información completa de la empresa asociada al número de IVA validado:

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

### Parámetros de solicitud

<ParamField query="api_key" type="String" required>
  Su clave API única. Tenga en cuenta que cada usuario tiene claves API únicas para cada una de las APIs de Cleariflow, por lo que su clave de la API de validación de IVA y tasas no funcionará para su API de geolocalización IP, por ejemplo.
</ParamField>

<ParamField query="vat_number" type="String" required>
  El número de IVA a validar.
</ParamField>

### Parámetros de respuesta

La respuesta de la API se devuelve en un [formato JSON](https://www.json.org/json-en.html) universal y ligero.

<ResponseField name="vat_number" type="String">
  El número de IVA a validar.
</ResponseField>

<ResponseField name="valid" type="Boolean">
  Es verdadero si el número de IVA enviado es válido.
</ResponseField>

<ResponseField name="company" type="Object">
  Objeto que contiene información de la empresa.
</ResponseField>

<ResponseField name="company.name" type="String">
  El nombre de la empresa asociada al número de IVA.
</ResponseField>

<ResponseField name="company.address" type="String">
  La dirección de la empresa asociada al número de IVA.
</ResponseField>

<ResponseField name="country" type="Object">
  Objeto que contiene información del país.
</ResponseField>

<ResponseField name="country.code" type="String">
  El código ISO 3166-1 alpha-2 de dos letras del país asociado al número de IVA.
</ResponseField>

<ResponseField name="country.name" type="String">
  El nombre del país asociado al número de IVA.
</ResponseField>