vatNumberCheck

A Vat Number Check contains all information from a Validation record in the Valdit VAT Validation system.

Element Description Type Mandatory
checkResult Check Result = ‘valid', ‘invalid’, ‘unknown’ string (enum) yes
unknownReason When available will indicate why the check has returned an ‘unknown’ checkResult string no
vatCountryCode Two-letter country code as used in the EU VAT System. Can be one of the following values: ‘AT’, ‘BE’, ‘BG’, ‘CY’, ‘CZ’, ‘DE’, ‘DK’, ‘EE’, ‘EL’, ‘ES’, ‘FI’, ‘FR’, ‘HR’, ‘HU’, ‘IE’, ‘IT’, ‘LT’, ‘LU’, ‘LV’, ‘MT’, ‘NL’, ‘PL’, ‘PT’, ‘RO’, ‘SE’, ‘SI’, ‘SK’, ‘XI’ vatCountryCode object (see paragraph 9.7) yes
vatNumber An organisation’s national VAT number as issued by the Tax Administration string yes
companyName Company Name string no
companyAddress Company Address string no
checkDate UTC Date-Time this check was made string (date-time_ yes
consultationNumber Consultation Number for this check as issued by the EU VAT-VIES service string no

Table 8: VatNumberCheck Model elements

Example

{ “checkResult”: “valid”, “unknownReason”: “string”, “vatCountryCode”: “BE”, “vatNumber”: “0420834005”, “companyName”: “SA S.A. SPA MONOPOLE, COMPAGNIE FERMIERE DE SPA”, “companyAddress”: “RUE AUGUSTE LAPORTE 34\n4900 SPA”, “checkDate”: “2016-08-03T07:37:53.688Z”, “consultationNumber”: “WAPIAAAAVXk7EWul” }