How to get EU VIES VAT Number Validator by webhook

Batch-validate EU VAT numbers via the official European Commission VIES REST API. A run saves one row per result.

Set up the Apify actor

Apify is where this run is collected. An actor is the program that collects the rows. A task is that program saved with your settings, so the next section can ask for the latest rows. You need a free Apify account.

01
Open EU VIES VAT Number Validator and click Try for free. Create an Apify account if you do not have one. The Free plan does not ask for a card.

You are on the input form. Keep the sample for this first run.

{
    "vatNumbers": [
        "IE6388047V"
    ],
    "maxItems": 5
}

03
Leave the proxy setting as it is. Click Start and wait until the run says Succeeded.
04
Open Storage, then Dataset. You should see inputVat, countryCode, vatNumber, isValid.
05
When you want the real list, raise maxItems. The sample cap is only there so the first run stays small.
06
Go back to the input and choose Save as a new task. Name it after this list.
07
Open the task. Copy the task ID from the address bar. Excel, Sheets, Power BI, and the other guides ask for this ID.
08
On the task, open Schedules and add a weekly run if you want fresh rows. Each run pays the start charge and the charge for the rows. The amounts are in the price list on this page.
09
Open Settings, then API & Integrations, and copy an API token. Excel, Sheets, and the other guides put this token in a download link. Anyone with that link can download the rows, so treat it like a password.

How to set up a webhook

Use the task ID and the API token from Set up the Apify actor, above.

01
In Apify, open EU VIES VAT Number Validator and go to Integrations.
02
Add a webhook for Actor run succeeded. Point it at the URL that should receive the run.
03
The payload includes the dataset id. Read the rows from that dataset, or from the task URL in the sections above.
04
The weekly schedule from Set up the Apify actor, above, is what makes this fire every week.

Schema

Examples come from the actor sample, not a live result.

Name	Description	Example
`inputVat`	Input Vat	`IE6388047V`
`countryCode`	Country Code	`IE`
`vatNumber`	Vat Number	`6388047V`
`isValid`	Is Valid	`true`
`requestDate`	Request Date	`2026-09-11T12:00:00Z`
`userError`	User Error	`VALID`
`name`	Name	`GOOGLE IRELAND LIMITED`
`address`	Address	`GORDON HOUSE, BARROW STREET, DUBLIN 4`
`sourceUrl`	Source Url	`https://ec.europa.eu/taxation_customs/vies/rest-api/ms/IE/vat/6388047V`
`scrapedAt`	Scraped At	`2026-09-11T12:00:00+00:00`

inputVatInput VatIE6388047V
countryCodeCountry CodeIE
vatNumberVat Number6388047V
isValidIs Validtrue
requestDateRequest Date2026-09-11T12:00:00Z
userErrorUser ErrorVALID
nameNameGOOGLE IRELAND LIMITED
addressAddressGORDON HOUSE, BARROW STREET, DUBLIN 4
sourceUrlSource Urlhttps://ec.europa.eu/taxation_customs/vies/rest-api/ms/IE/vat/6388047V
scrapedAtScraped At2026-09-11T12:00:00+00:00