---
title: "Konto- und Abo-Status zum vorgelegten Credential"
method: GET
path: "/me"
tags: ["Konto"]
---

# Konto- und Abo-Status zum vorgelegten Credential

`GET /me`

## Request

- Base URL: `https://finisma.de/api/v1`
- URL: `https://finisma.de/api/v1/me`
- 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`)

Prüft, ob das Credential trägt, und meldet, welche Funktionen damit erlaubt sind. Gedacht für Verbindungstests in Integrationen.

## Response `200`

Kontostatus.

- object
  - `email` string, required
  - `credits` integer, required: Guthaben-Saldo: 1 Credit = 1 Rechnung ohne Wasserzeichen (auch über POST /invoices, ohne Tageslimit). Aufladen unter https://finisma.de/konto.
  - `subscription` object, required
    - `status` string, required
    - `active` boolean, required
    - `currentPeriodEnd` string, date-time, nullable
    - `cancelAtPeriodEnd` boolean
  - `scopes` string[], nullable: Bei OAuth die zugestimmten Scopes, bei API-Key null (voller Umfang).
  - `capabilities` object, required
    - `verify` boolean, required
    - `create` boolean, required
  - `features` string[], required: Gebuchte Bausteine des Kontos, unabhängig vom OAuth-Scope. converter ist in jedem aktiven Abo enthalten; payments (Zahlungsverkehr-Abo) schaltet GET /payments/bank-lookup und POST /payments/sepa frei, paymentsAbroad (Auslandsmodul-Add-on, setzt payments voraus) zusätzlich POST /payments/structure-addresses und POST /payments/axz.
  - `fairUse` object, nullable: Fair Use des Abos im laufenden Kalendermonat (Europe/Berlin), ohne aktives Abo null. limit = 100 + 1.000 je gebuchtem Zusatzpaket; used zählt die Rechnungen ohne Wasserzeichen aus dem Abo (Web, API, MCP) und ist null, wenn der Zähler gerade nicht lesbar ist. Die Grenze sperrt nichts. Wer regelmäßig darüber liegt, bucht im Konto ein Zusatzpaket.
    - `month` string: Kalendermonat, z. B. 2026-10.
    - `limit` integer
    - `used` integer, nullable
    - `volumePackages` integer

## Other responses

- `400`: Ungültige Eingabe.
- `401`: Kein oder ungültiges Credential.
- `429`: Rate-Limit oder kostenloses Tageskontingent erschöpft (siehe Retry-After).
- `502`: Fehler im nachgelagerten Dienst.

---

[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)