Paulibytes UG (haftungsbeschränkt)

Paulibytes UG (haftungsbeschränkt) Konto API

Konto- und Abo-Status zum vorgelegten Credential.

GitHub OpenAPI

Operations 1

GET /me Konto- und Abo-Status zum vorgelegten Credential #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/finisma-de/openapi/finisma-de-konto-api-openapi.yml

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/finisma-de/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/finisma-de:finisma-de-konto-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

finisma-de-konto-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: finisma REST Konto API
  version: 1.0.0
  description: Elektronische Rechnungen (ZUGFeRD/Factur-X, EN 16931) prüfen und erzeugen. Server-zu-Server-API; nicht für Browser-Aufrufe gedacht. Authentifizierung per API-Key (Bearer fnsm_…), erstellt unter /konto, oder OAuth 2.1 (Bearer fnso_…) für Integrationen, die das Konto des Nutzers verbinden. verify ist kostenlos (Credential nötig), invoices läuft mit Abo, Guthaben (Credits, 1 je Rechnung) oder dem kostenlosen Tageskontingent mit Wasserzeichen, extractions läuft mit Abo oder kostet 1 Credit je Aufruf (Sprachmodell). payments/validate und statements/validate haben ein kostenloses Tageskontingent je Konto, danach Zahlungsverkehr-Abo oder Prüfblock (1 Credit für 10 Prüfungen); statements/parse hat ein kostenloses Monatskontingent, danach Zahlungsverkehr-Abo oder 1 Credit je Aufruf (Details je Endpunkt, x-finisma-pricing). Operationen mit x-finisma-mcp-tool gibt es unter demselben Tool-Namen auch auf dem Remote-MCP-Server /api/mcp.
  termsOfService: https://finisma.de/agb
  contact:
    name: finisma
    email: erechnung@paulibytes.de
    url: https://finisma.de/entwickler
servers:
- url: https://finisma.de/api/v1
security:
- bearerAuth: []
- oauth2:
  - invoice:verify
  - invoice:create
tags:
- name: Konto
  description: Konto- und Abo-Status zum vorgelegten Credential.
paths:
  /me:
    get:
      operationId: getAccount
      summary: Konto- und Abo-Status zum vorgelegten Credential
      tags:
      - Konto
      description: Prüft, ob das Credential trägt, und meldet, welche Funktionen damit erlaubt sind. Gedacht für Verbindungstests in Integrationen.
      responses:
        '200':
          description: Kontostatus.
          content:
            application/json:
              schema:
                type: object
                properties:
                  email:
                    type: string
                  credits:
                    type: integer
                    description: 'Guthaben-Saldo: 1 Credit = 1 Rechnung ohne Wasserzeichen (auch über POST /invoices, ohne Tageslimit). Aufladen unter https://finisma.de/konto.'
                  subscription:
                    type: object
                    properties:
                      status:
                        type: string
                      active:
                        type: boolean
                      currentPeriodEnd:
                        type:
                        - string
                        - 'null'
                        format: date-time
                      cancelAtPeriodEnd:
                        type: boolean
                    required:
                    - status
                    - active
                  scopes:
                    type:
                    - array
                    - 'null'
                    items:
                      type: string
                    description: Bei OAuth die zugestimmten Scopes, bei API-Key null (voller Umfang).
                  capabilities:
                    type: object
                    properties:
                      verify:
                        type: boolean
                      create:
                        type: boolean
                    required:
                    - verify
                    - create
                  features:
                    type: array
                    items:
                      type: string
                      enum:
                      - converter
                      - payments
                      - paymentsAbroad
                    description: 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:
                    type:
                    - object
                    - 'null'
                    description: 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.
                    properties:
                      month:
                        type: string
                        description: Kalendermonat, z. B. 2026-10.
                      limit:
                        type: integer
                      used:
                        type:
                        - integer
                        - 'null'
                      volumePackages:
                        type: integer
                required:
                - email
                - credits
                - subscription
                - capabilities
                - features
        '400':
          description: Ungültige Eingabe.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Kein oder ungültiges Credential.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate-Limit oder kostenloses Tageskontingent erschöpft (siehe Retry-After).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Fehler im nachgelagerten Dienst.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Menschenlesbare Fehlermeldung.
        code:
          type: string
          enum:
          - invalid_input
          - auth_required
          - invalid_key
          - subscription_required
          - free_quota_exhausted
          - payment_required
          - payload_too_large
          - insufficient_scope
          - rate_limited
          - not_found
          - upstream_error
        details:
          description: Optionale strukturierte Details, z. B. Validierungs-Issues.
      required:
      - error
      - code
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API-Key (fnsm_…) aus dem finisma-Konto unter /konto oder OAuth-Zugriffstoken (fnso_…).
    oauth2:
      type: oauth2
      description: OAuth 2.1 mit PKCE (S256). Clients können sich per Dynamic Client Registration unter /api/oauth/register selbst anmelden.
      flows:
        authorizationCode:
          authorizationUrl: https://finisma.de/api/oauth/authorize
          tokenUrl: https://finisma.de/api/oauth/token
          refreshUrl: https://finisma.de/api/oauth/token
          scopes:
            invoice:verify: E-Rechnungen prüfen
            invoice:create: ZUGFeRD-Rechnungen erzeugen