---
title: "USt-IdNr. live gegen VIES prüfen (kostenlos, Key nötig)"
method: GET
path: "/vat/check"
tags: ["Partner-Checks"]
---

# USt-IdNr. live gegen VIES prüfen (kostenlos, Key nötig)

`GET /vat/check`

## Request

- Base URL: `https://finisma.de/api/v1`
- URL: `https://finisma.de/api/v1/vat/check`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://finisma.de/api/oauth/authorize`, token URL `https://finisma.de/api/oauth/token`, scopes: `invoice:verify`, `invoice:create`)

## Query parameters

- `vatId` string, required

## Response `200`

Prüfergebnis. status ist valid, invalid oder unavailable — unavailable heißt VIES/Mitgliedsstaat nicht erreichbar, NICHT ungültig.

- object

## Other responses

- `400`: Keine als USt-IdNr. erkennbare Eingabe.
- `429`: Rate-Limit (30/min je Key).

---

[API](https://skmtc.dev/finisma/apis/finisma-rest-api.md) · [All operations](https://skmtc.dev/finisma/apis/finisma-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finisma/apis/finisma-rest-api/revisions/c1a9acfab69b?raw)