Dokumentation

API-Referenz

GET/api/v1/applications/{id}/fees

Gebühren auflisten

Alle Beträge sind Integerwerte in Euro-Cent. Dadurch entstehen keine Rundungsfehler durch Fließkommazahlen. Der Endpunkt benötigt applications:read.

Beschreibung

Liefert Gebührenpositionen, Gesamtsumme und verfügbare Bescheide.

Parameter

idpathPflicht

Öffentliche Antrags-ID.

Beispiel: app_test_1a2b3c4d5e6f708192a3b4c5

Responses

200

Liste der Gebührenrevisionen; data kann leer sein.

401/403

API-Schlüssel oder Scope applications:read ist ungültig.

404

Antrag fehlt oder gehört zu einem anderen Mandanten beziehungsweise einer anderen Umgebung.

Response-Body

Content-Type: application/json. Die erfolgreiche Antwort enthält die nachfolgend beschriebenen Felder.

Response-Felder

FeldTypAngabeBeschreibung
objectstringImmerKonstanter Wert list.
dataarrayImmerGebührenrevisionen des Antrags.
data[].idstringImmerÖffentliche Gebühren-ID.
data[].objectstringImmerKonstanter Wert official_fee.
data[].amountintegerImmerGesamtbetrag in Euro-Cent.
data[].amount_netintegerImmerNettobetrag in Euro-Cent.
data[].vat_amountintegerImmerUmsatzsteuerbetrag in Euro-Cent.
data[].currencystringImmerKonstanter Wert EUR.
data[].revisionintegerOptionalFortlaufende Gebührenrevision.
data[].currentbooleanImmerKennzeichnet die aktuell wirksame Revision.
data[].componentsarrayImmerEinzelpositionen mit Code, Bezeichnung und Betrag in Euro-Cent.
data[].notice_urlstringOptionalDownloadpfad des Gebührenbescheids.
data[].created_atdate-timeOptionalErstellungszeitpunkt.
200 Response-Beispieljson
{
  "object": "list",
  "data": [
    {
      "id": "fee_9",
      "object": "official_fee",
      "amount": 3170,
      "amount_net": 3170,
      "vat_amount": 0,
      "currency": "EUR",
      "revision": 1,
      "current": true,
      "components": [
        {
          "code": "API_TEST",
          "name": "Simulierte amtliche Gebühr",
          "amount": 3170
        }
      ],
      "notice_url": "/api/v1/applications/app_test_1a2b3c4d5e6f708192a3b4c5/fees/fee_9/document",
      "created_at": "2026-08-23T10:50:00+02:00"
    }
  ]
}

Beträge verarbeiten

3170 entspricht 31,70 EUR. Formatieren Sie Beträge erst in Ihrer Anzeige; rechnen und speichern Sie weiterhin mit dem Cent-Integer. Das gilt auch für Komponenten und Tarifbeträge im Antragsobjekt.

Noch keine Gebühren

Bei laufenden Anträgen kann data leer sein. Gebühren werden erst nach ihrer Bereitstellung gelistet.

Zum Öffnen eines Treffers Enter drücken.