---
title: "Die Zahlen für die Umsatzsteuer-Voranmeldung eines Zeitraums"
method: GET
path: "/api/v1/umsatzsteuer"
---

# Die Zahlen für die Umsatzsteuer-Voranmeldung eines Zeitraums

`GET /api/v1/umsatzsteuer`

## Request

- Base URL: `https://rechnungslotse.de`
- URL: `https://rechnungslotse.de/api/v1/umsatzsteuer`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://rechnungslotse.de/authorize`, token URL `https://rechnungslotse.de/api/oauth/token`, scopes: `lesen`)

Die Zahlen für die Umsatzsteuer-Voranmeldung eines Zeitraums. `von` und `bis` sind Pflicht (`JJJJ-MM-TT`). Soll oder Ist entscheidet der Betrieb über `versteuerung` und nicht der Aufruf – ein Parameter dafür wäre die Einladung, sich die günstigere Zahl auszusuchen.

## Response `200`

200 mit einer Zeile je ELSTER-Kennziffer (Netto und Steuer in Cent), den Summen und der Zahl der berücksichtigten Belege. Die Aufstellung stammt nur aus Ausgangsrechnungen: keine Vorsteuer, kein § 13b als Leistungsempfänger, keine Korrekturen aus Vormonaten. Der Hinweis steht als `disclaimer` in der Antwort und gehört mit angezeigt.

- object

## Other responses

- `401`: Kein oder ungültiger Zugangsschlüssel: api_schluessel_ungueltig, api_schluessel_abgelaufen
- `403`: Recht „lesen“ fehlt am Schlüssel.
- `429`: Ratengrenze oder Kontingent: quota_exhausted, rate_limited. Retry-After sagt, wann.
- `503`: Prüfdienst nicht erreichbar – später wiederholen.

---

[API](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1.md) · [All operations](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1/revisions/0997b13254c2?raw)