Saltar al contenido principal
GET
/
v1
/
validate
Endpoint de validación de IVA
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"
}

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:
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

Parámetros de solicitud

api_key
String
requerido
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.
vat_number
String
requerido
El número de IVA a validar.

Parámetros de respuesta

La respuesta de la API se devuelve en un formato JSON universal y ligero.
vat_number
String
El número de IVA a validar.
valid
Boolean
Es verdadero si el número de IVA enviado es válido.
company
Object
Objeto que contiene información de la empresa.
company.name
String
El nombre de la empresa asociada al número de IVA.
company.address
String
La dirección de la empresa asociada al número de IVA.
country
Object
Objeto que contiene información del país.
country.code
String
El código ISO 3166-1 alpha-2 de dos letras del país asociado al número de IVA.
country.name
String
El nombre del país asociado al número de IVA.