Files
VIES-VAT-ID-checker-API/README.md
2025-06-30 09:10:16 +00:00

1013 B

VAT Number Validation API

This Node.js application provides an API interface to validate European VAT numbers using the official VIES SOAP service.

Features

  • Validate VAT numbers for any EU member state
  • GET and POST HTTP support
  • JSON responses with company name, address, and validity

Installation

npm install express cors body-parser soap

Usage

Start the server

node server.js

Endpoints

GET /api/validate-vat

Query parameters:

  • countryCode: ISO 2-letter country code (e.g., SK, DE, FR)
  • vatNumber: VAT number without country code

Example:

http://localhost:3000/api/validate-vat?countryCode=SK&vatNumber=1234567890

POST /api/validate-vat

Request body (JSON):

{
  "countryCode": "SK",
  "vatNumber": "1234567890"
}

Response:

{
  "country": "SK",
  "VAT": "1234567890",
  "name": "Example Company",
  "address": "Main Street 123, City, Country",
  "valid": true
}

License

MIT