VAT Number Verification

How It Works

Extracts VAT number from a receipt
Verifies the authenticity of VAT numbers using VIES
Checks the existence of VAT numbers in the country's companies register
Returns prompt results with valid VAT numbers or informative error messages

Compatible Endpoints

The VAT Number Verification feature is available on the following Data Extraction API Endpoints endpoints:

Enabling VAT Number Verification

To use VAT number verification, set the verifyVAT parameter to true in your API request:

curl --request POST \
  --url https://api.taggun.io/api/receipt/v1/verbose/file \
  --header 'accept: application/json' \
  --header 'apikey: YOUR_API_KEY' \ # UPDATE To Your API Key
  --header 'content-type: multipart/form-data' \
  --form 'file=@/path/to/your/receipt.jpg' \ # UPDATE To Your File Path
  --form 'verifyVAT=true'

Understanding the Response

The verified VAT number information is found in the vatNumber object inside the entities object of the response. It contains:

VAT Number Data Fields

Field Name	Type	Description	Access Path
VAT Number	String	The extracted and verified VAT number	`entities.vatNumber.data`
Country Code	String	The country code associated with the VAT number	`entities.vatNumber.countryCode`
Valid	Boolean	Indicates if the VAT number is valid	`entities.vatNumber.valid`
Company Name	String	The registered company name (if available)	`entities.vatNumber.companyName`
Company Address	String	The registered company address (if available)	`entities.vatNumber.companyAddress`

Additional VAT Number Properties

Field	Description
confidenceLevel	A measure of how confident the system is about the extracted information.
regions	The location of the text on the image (coordinates not shown for readability)

Response Body

You can find vatNumber inside the entities object:

{
  "entities": {
    "vatNumber": {
      "data": "GB660454836",
      "countryCode": "GB",
      "valid": true,
      "companyName": "Example Company Ltd",
      "companyAddress": "123 Business Street, London, UK",
      "confidenceLevel": 0.95,
      "regions": []
    }
  }
}

Supported Countries

European countries that are currently using the VIES system:

Austria, Belgium, Bulgaria, Croatia, Cyprus, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia