Validation TVA UE

Valide un numéro de TVA UE via le service VIES de la Commission européenne, avec statut d’indisponibilité explicite.

0.005 USD

Facturation sur résultat valide · Résultat vide non facturé · Erreur non facturée

Quand utiliser cette API ?

À utiliser pour

  • Valider un numéro de TVA UE avant facturation ou référencement fournisseur.

À éviter quand

  • Utilisez une API plus spécialisée si vous n’avez besoin que d’une donnée élémentaire déjà disponible.

Limitations

  • Les résultats dépendent de la disponibilité et du périmètre des sources publiques citées.

Sources et provenance

European Commission VIES

ec.europa.eu

Schémas Input / Output

Contrats simplifiés de l’endpoint. Le schéma complet reste disponible dans OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
vat_numberstring

country_codestring

numberstring

Voir le JSON Schema complet
{
    "type": "object",
    "properties": {
        "vat_number": {
            "type": "string",
            "pattern": "^(?:AT|BE|BG|CY|CZ|DE|DK|EE|EL|ES|FI|FR|GR|HR|HU|IE|IT|LT|LU|LV|MT|NL|PL|PT|RO|SE|SI|SK|XI)[A-Za-z0-9]{2,14}$"
        },
        "country_code": {
            "type": "string",
            "enum": [
                "AT",
                "BE",
                "BG",
                "CY",
                "CZ",
                "DE",
                "DK",
                "EE",
                "EL",
                "ES",
                "FI",
                "FR",
                "GR",
                "HR",
                "HU",
                "IE",
                "IT",
                "LT",
                "LU",
                "LV",
                "MT",
                "NL",
                "PL",
                "PT",
                "RO",
                "SE",
                "SI",
                "SK",
                "XI"
            ]
        },
        "number": {
            "type": "string",
            "pattern": "^[A-Za-z0-9]{2,14}$"
        }
    },
    "additionalProperties": false,
    "anyOf": [
        {
            "required": [
                "vat_number"
            ]
        },
        {
            "required": [
                "country_code",
                "number"
            ]
        }
    ]
}
Output schema
vat_numberstring

Obligatoire

country_codestring

Obligatoire

numberstring

Obligatoire

statusstring

Obligatoire

validboolean | null

Obligatoire

request_datestring | null

Obligatoire

namestring | null

Obligatoire

addressstring | null

Obligatoire

request_identifierstring | null

Obligatoire

checked_atstring

Obligatoire

sourcestring

Obligatoire

Voir le JSON Schema complet
{
    "type": "object",
    "properties": {
        "vat_number": {
            "type": "string"
        },
        "country_code": {
            "type": "string"
        },
        "number": {
            "type": "string"
        },
        "status": {
            "type": "string"
        },
        "valid": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "request_date": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "address": {
            "type": [
                "string",
                "null"
            ]
        },
        "request_identifier": {
            "type": [
                "string",
                "null"
            ]
        },
        "checked_at": {
            "type": "string"
        },
        "source": {
            "type": "string"
        }
    },
    "additionalProperties": false,
    "required": [
        "vat_number",
        "country_code",
        "number",
        "status",
        "valid",
        "request_date",
        "name",
        "address",
        "request_identifier",
        "checked_at",
        "source"
    ]
}

Exemples de requêtes

Valider un numéro de TVA UE avant facturation ou référencement fournisseur.