---
title: EU VAT Number Details API
slug: eu-vat-number-details
url: https://apyhub.com/freedailypro/service/eu-vat-number-details
provider: FreeDailyPro
categories: [Verification Kit]
tags: [vat-validation, eu-vat, vies, tax-validation, business-verification]
auth: api_key
version: 1.4.0
service_type: sync
endpoints: 1
atoms: 10
mcp: true
---

# EU VAT Number Details API

Validate EU VAT numbers with layout checks and live VIES lookup. Use it to confirm customer or supplier VAT IDs before billing or onboarding.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/freedailypro/eu-vat-number-details/converters/vat-validate` | What it does Checks an EU VAT number in two steps. First it checks that the number has the right la… | 10 |

## Endpoint reference

### Validate an EU VAT number: layout check per member state plus a live VIES lookup

`POST https://api.eu.apyhub.com/freedailypro/eu-vat-number-details/converters/vat-validate` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `country` | body | string | no | Two-letter country code when vatNumber has no prefix (Greece is EL). |
| `vatNumber` | body | string | yes | The EU VAT number, with or without the two-letter prefix and with spaces or dots, for example DE123456789 or 'DE 123.456.789'. |
| `offlineOnly` | body | boolean | no | true checks only the number layout and skips the live VIES lookup. |

Check a Dutch VAT number and get the registered company details.

**cURL**

```bash
curl -X POST "https://api.apyhub.com/<service-path>" \
  -H "apy-token: YOUR_APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"vatNumber": "NL862735944B01"}'
```

**Response**

```json
{
  "result": {
    "vatNumber": "NL862735944B01",
    "country": "NL",
    "countryName": "Netherlands",
    "formatValid": true,
    "valid": true,
    "checked": "vies",
    "name": "APYHUB B.V.",
    "address": "KEIZERSGRACHT 00520 H\n1017EK AMSTERDAM",
    "requestDate": "2026-11-11T08:19:08.682Z"
  }
}
```

## About

## What it does
EU VAT Number Validator checks whether an EU VAT number is formatted correctly and can be verified against the live VIES service. Send a `vatNumber`, and optionally `country` when the number has no prefix. If you only want a syntax check, set `offlineOnly` to `true`.

Use it when you need to confirm a customer or supplier VAT ID before creating an account, issuing an invoice, or applying reverse-charge tax logic. The validator accepts common formatting variations such as spaces or dots, so `DE123456789` and `DE 123.456.789` are treated as the same number.

The service returns a JSON object, so you can plug it into onboarding flows, billing systems, or back-office checks without adding your own VAT parsing logic. It is useful both for quick validation at form submit time and for deeper compliance checks that depend on a live VIES lookup.

If a VAT number is missing its country prefix, provide the two-letter country code separately. Greece uses `EL` in place of `GR` for VAT prefix handling.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/freedailypro/service/eu-vat-number-details