# EU VAT Validator (VIES) Scraper (`parseforge/vies-eu-vat-scraper`) Actor Validate EU VAT numbers across all 27 member states with VIES. Get company name, address, country, and validity status for any European VAT ID. Essential for cross-border invoicing, compliance checks, and B2B customer verification. - **URL**: https://apify.com/parseforge/vies-eu-vat-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Business, Lead generation, Other - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg) ## ๐Ÿ‡ช๐Ÿ‡บ VIES EU VAT Validator Cross-border invoicing in the EU requires valid VAT numbers. VIES is the European Commission's official VAT validation system. This tool batch-validates EU VAT numbers, returns the registered company name and address, and flags invalid entries so you can clean up your customer database in one pass. > **The VIES EU VAT Validator checks batches of EU VAT numbers and returns validity status, registered company name, full address with street and postal code split into fields, and request timestamps from the official EU validation system.** ### โœจ What Does It Do - โœ… **Valid/invalid check** - confirms each VAT number is currently registered and active - ๐Ÿข **Company name** - returns the official registered name when available - ๐Ÿ“ **Full address** - street, postal code, city split into structured fields - ๐ŸŒ **All 27 EU states + XI** - 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 (Northern Ireland) - ๐Ÿ“ฆ **Batch processing** - validate dozens or thousands of VATs in one run - โฑ๏ธ **Request timestamps** - official EU timestamp for each validation for audit trails ### ๐Ÿ”ง Input - **VAT Numbers** - list of EU VAT numbers with country prefix (e.g. `IT00159560366`, `DE811109517`, `FR12345678901`) - **Max Items** - free users get 10 validations, paid users up to 1,000,000 ```json { "vatNumbers": [ "IT00159560366", "DE811109517", "FR12345678901", "NL001234567B01" ], "maxItems": 100 } ```` ### ๐Ÿ“Š Output Each VAT check returns a full record with validity and company info. Download as JSON, CSV, or Excel. | ๐Ÿ“Œ Field | ๐Ÿ“„ Description | |----------|---------------| | ๐Ÿท๏ธ vatNumber | Cleaned VAT number with country prefix | | ๐ŸŒ countryCode | 2-letter EU country code | | โœ… isValid | Boolean validity flag | | ๐Ÿข name | Registered company name | | ๐Ÿ  address | Full formatted address | | ๐Ÿ›ฃ๏ธ street | Street line (parsed) | | ๐Ÿ“ฎ postalCode | Postal code (parsed) | | ๐Ÿ™๏ธ city | City (parsed) | | ๐Ÿ›๏ธ companyType | Company type if returned | | โฑ๏ธ requestDate | Official EU timestamp | ```json { "vatNumber": "IT00159560366", "countryCode": "IT", "isValid": true, "name": "FERRARI S.P.A.", "address": "VIA EMILIA EST 1163, 41122 MODENA MO", "street": "VIA EMILIA EST 1163", "postalCode": "41122", "city": "MODENA MO", "companyType": null, "requestDate": "2026-04-10+02:00", "scrapedAt": "2026-04-10T12:00:00.000Z" } ``` ### ๐Ÿ’Ž Why Choose the VIES EU VAT Validator? | Feature | Our Tool | Manual VIES Form | |---------|----------|------------------| | Batch validation | โœ… Thousands per run | โŒ One at a time | | All 27 EU states | โœ… Yes | โœ… Yes | | Parsed address fields | โœ… Street / postcode / city | โŒ Single text blob | | Company name returned | โœ… When published | โœ… When published | | Audit-ready timestamps | โœ… Included | โš ๏ธ Must record manually | | Export to JSON/CSV/Excel | โœ… Yes | โŒ Not supported | ### ๐Ÿ“‹ How to Use 1. **Sign Up** - [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. **Configure** - paste your list of VAT numbers with country prefixes 3. **Run It** - click Start and get validation results in seconds No coding, no one-by-one form submissions. ### ๐ŸŽฏ Business Use Cases - ๐Ÿ’ฐ **Invoice validation** - verify customer VAT numbers before issuing zero-rated cross-border invoices - โœ… **KYC / onboarding** - confirm new B2B customers are real registered companies - ๐Ÿงน **Database cleanup** - flag stale or invalid VAT records in your CRM - ๐Ÿ“Š **Compliance reporting** - maintain an audit trail of VAT checks with EU timestamps - ๐Ÿ›’ **E-commerce** - validate business customer VAT numbers at checkout for reverse charge - ๐Ÿ”„ **Recurring billing** - re-check VAT validity periodically for subscription customers ### โ“ FAQ ๐Ÿ‡ช๐Ÿ‡บ **What is VIES?** VIES (VAT Information Exchange System) is the official EU service that allows businesses to check the validity of VAT numbers issued in any EU member state. ๐ŸŒ **Which country codes are supported?** All 27 EU member states plus `XI` for Northern Ireland: AT, BE, BG, CY, CZ, DE, DK, EE, EL (Greece), ES, FI, FR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK, XI. ๐Ÿข **Will I always get a company name?** No. Some member states restrict publishing the name and address via VIES. In those cases, `isValid` is still returned but `name` and `address` may be empty. โฑ๏ธ **Is the data real-time?** Yes. Every check hits VIES live, so the result reflects the current registration status at the time of the run. ๐Ÿ“„ **Can I keep these results for audit?** Yes. The `requestDate` field contains the official EU timestamp you can store for VAT compliance records. ### ๐Ÿ”— Integrate VIES EU VAT Validator with any app - [Make](https://docs.apify.com/platform/integrations/make) - automate VAT checks - [Zapier](https://docs.apify.com/platform/integrations/zapier) - validate new customers on signup - [Slack](https://docs.apify.com/platform/integrations/slack) - alert on invalid VAT numbers - [Google Sheets](https://docs.apify.com/platform/integrations/drive) - maintain a validated customer sheet - [Webhooks](https://docs.apify.com/platform/integrations/webhooks) - trigger billing workflows on completion ### ๐Ÿ’ก Recommended Actors Looking for more data collection tools? Check out these related actors: | Actor | Description | Link | |-------|-------------|------| | FINRA BrokerCheck Scraper | US broker registration lookups | [Link](https://apify.com/parseforge/finra-brokercheck-scraper) | | GSA eLibrary Scraper | US government contract data | [Link](https://apify.com/parseforge/gsa-elibrary-scraper) | | BizBuySell Scraper | Businesses for sale listings | [Link](https://apify.com/parseforge/bizbuysell-scraper-pay-per-event) | | Pitchbook Investors Scraper | PE and VC investor profiles | [Link](https://apify.com/parseforge/pitchbook-investors-scraper) | | DealStream Scraper | Business for sale marketplace | [Link](https://apify.com/parseforge/dealstream-scraper) | **Pro Tip:** ๐Ÿ’ก Browse the full [ParseForge catalog](https://apify.com/parseforge) to find more data tools. ### ๐Ÿ†˜ Need Help? - Check the FAQ section above for common questions - Visit the [Apify documentation](https://docs.apify.com) for platform guides - Contact us at [Tally contact form](https://tally.so/r/BzdKgA) ### โš ๏ธ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or connected to VIES, the European Commission, or any EU institution. It uses only publicly available validation services. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `vatNumbers` (type: `array`): VAT numbers with country prefix (e.g. 'IT00159560366', 'DE811109517', 'FR12345678901'). ## Actor input object example ```json { "maxItems": 10, "vatNumbers": [ "IT00159560366", "DE811109517", "FR12345678901" ] } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "vatNumbers": [ "IT00159560366", "DE811109517", "FR12345678901" ] }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/vies-eu-vat-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "vatNumbers": [ "IT00159560366", "DE811109517", "FR12345678901", ], } # Run the Actor and wait for it to finish run = client.actor("parseforge/vies-eu-vat-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "vatNumbers": [ "IT00159560366", "DE811109517", "FR12345678901" ] }' | apify call parseforge/vies-eu-vat-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/vies-eu-vat-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EU VAT Validator (VIES) Scraper", "description": "Validate EU VAT numbers across all 27 member states with VIES. Get company name, address, country, and validity status for any European VAT ID. Essential for cross-border invoicing, compliance checks, and B2B customer verification.", "version": "1.0", "x-build-id": "p5knzN3CeWiH1z47p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~vies-eu-vat-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-vies-eu-vat-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~vies-eu-vat-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-vies-eu-vat-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~vies-eu-vat-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-vies-eu-vat-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "vatNumbers": { "title": "VAT Numbers", "type": "array", "description": "VAT numbers with country prefix (e.g. 'IT00159560366', 'DE811109517', 'FR12345678901').", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```