Rails EU VAT Validation

Ruby on Rails concern and model validator for EU VAT numbers

Quick Start

1. Get a free API key at eurovalidate.com
2. Clone this repo: git clone https://github.com/eurovalidate/rails-vat-validation.git
3. Copy .env.example to .env and add your API key
4. Install dependencies and run (see below)

Setup

bundle install && rails server

What This Does

Ruby on Rails concern and model validator for EU VAT numbers. Uses the EuroValidate API for real-time validation against official EU government sources (VIES, HMRC, GLEIF).

API Response Example

{
  "vat_number": "NL820646660B01",
  "country_code": "NL",
  "status": "valid",
  "company_name": "ABN AMRO BANK N.V.",
  "meta": {
    "confidence": "high",
    "source": "vies_cached",
    "cached": true,
    "response_time_ms": 2
  }
}

Test VAT Numbers

VAT	Country	Expected
NL820646660B01	Netherlands	Valid
FR40303265045	France	Valid
IT00159560366	Italy	Valid
DE000000000	Germany	Invalid

Links

• EuroValidate API Docs
• Get Free API Key (no credit card)
• Python SDK (pip install eurovalidate)
• Node.js SDK (npm install @eurovalidate/sdk)
• PHP SDK (composer require eurovalidate/sdk)

License

MIT