Backend Ready

VAT Check EU API

This Next.js service exposes a small REST API for validating EU VAT numbers. It sits in front of the official VIES SOAP endpoint and returns normalized JSON for the Expo app.

Endpoints

GET/api/health

Basic uptime and service metadata

POST/api/vat/lookup

Validate an EU VAT number against the VIES SOAP service

Request Example

curl -X POST https://your-api-domain.vercel.app/api/vat/lookup \
  -H "Content-Type: application/json" \
  -d '{"vatNumber":"IE6388047V"}'

Response Shape

{
  "ok": true,
  "data": {
    "countryCode": "IE",
    "countryName": "Ireland",
    "vatNumber": "6388047V",
    "formattedVatNumber": "IE6388047V",
    "requestDate": "2026-04-14+02:00",
    "valid": true,
    "companyName": "GOOGLE IRELAND LIMITED",
    "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
    "addressLines": ["3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4"]
  }
}

Operational Notes

The response reflects data provided by EU member states through VIES. Availability and data quality are controlled by the upstream service.

The mobile app can point at this API with EXPO_PUBLIC_API_URL, or infer a local LAN URL during Expo development.