# IBAN & VAT Number Validation

Validate IBAN and EU VAT numbers offline in milliseconds: country format and check digits, with no dependence on VIES being up.

Two offline checks for checkout forms, invoicing and onboarding. The IBAN check covers the countries of the IBAN registry: right length for the country and valid check digits, with the IBAN returned in electronic and printed form. The VAT check covers the 27 EU member states and Northern Ireland: the country's format, plus the check digit where the country publishes one. Answers come in milliseconds and nothing is stored. This does not confirm that an account exists or that a VAT number is registered.

- Offline checks: answers in milliseconds, and your checkout does not stop when VIES is down.
- IBAN length and mod-97 check digits for every country of the IBAN registry; EU VAT format for 27 member states and Northern Ireland, with the check digit for 20 of them.
- Nothing is stored.

## Calls

### `POST https://readymadeapi.com/v1/iban/check`

Is this IBAN well formed? Checks the country, its length and the mod-97 check digits, and returns it tidied.

- Price: $0.00016 per check
- MCP tool: `iban_vat_iban`
- Answers in the same call.

Request:

```json
{
  "iban": "RO49 AAAA 1B31 0075 9384 0000"
}
```

Answer:

```json
{
  "valid": true,
  "reason": null,
  "iban": "RO49AAAA1B31007593840000",
  "printed": "RO49 AAAA 1B31 0075 9384 0000",
  "country": "RO",
  "bban": "AAAA1B31007593840000"
}
```

### `POST https://readymadeapi.com/v1/vat/check`

Is this EU VAT number well formed? Checks the country's format and, for 20 countries, its check digit. Does not look it up in VIES.

- Price: $0.00016 per check
- MCP tool: `iban_vat_vat`
- Answers in the same call.

Request:

```json
{
  "number": "DE136695976"
}
```

Answer:

```json
{
  "valid": true,
  "country": "DE",
  "number": "DE136695976",
  "format_valid": true,
  "checksum": "valid"
}
```

## Limits

- One number per call.

## Questions

**Does it confirm the account or the VAT registration exists?**

No. It catches mistyped numbers before they cost you a failed payment or a rejected invoice. It does not look anything up at a bank or in VIES.

**Does it return the bank name or BIC?**

No. It checks the number's country, length and check digits and returns the IBAN in electronic and printed form.

**Which countries get a VAT check digit?**

20 of the 27, among them Germany, Italy, Poland, Romania, Sweden, Belgium and Austria. For the others the format is checked.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
