> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guthabeninformationen abrufen

> Gibt das Guthaben des authentifizierten Teams, die Aufschlüsselung pro Los, das aktive Abonnement und ob die Nutzung erlaubt ist, zurück.

Für eine geführte Übersicht siehe [Kontostand & Abrechnung](/balance-billing/balance-and-billing).


## OpenAPI

````yaml de/openapi/billing.json GET /user/credits/info
openapi: 3.0.3
info:
  title: Balance & Billing API
  version: 1.0.0
  description: Lese das Guthaben und kaufe Aufladungen für das authentifizierte Team.
servers:
  - url: https://api.olostep.com
security: []
tags:
  - name: Balance & Billing
    description: Endpunkte für Guthaben und Aufladekäufe.
paths:
  /user/credits/info:
    get:
      tags:
        - Balance & Billing
      summary: Kreditinformationen abrufen
      description: >-
        Gibt das Guthaben des authentifizierten Teams, die Aufschlüsselung pro
        Los, das aktive Abonnement und ob die Nutzung erlaubt ist, zurück.
        Nützlich für Abrechnungs-Widgets, Nutzungs-Dashboards und Vorabprüfungen
        vor großen Aufträgen.
      responses:
        '200':
          description: Kreditguthaben und Abrechnungskontext für das authentifizierte Team.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreditsInfoResponse'
              example:
                credits: 12500
                breakdown:
                  - purchase_kind: Subscription
                    allocated_units: 10000
                    remaining_units: 8500
                    expiry_date: 1735689600
                  - purchase_kind: Top-up
                    allocated_units: 5000
                    remaining_units: 4000
                    expiry_date: 1743465600
                active_subscription:
                  id: SUB_PRO
                  display_name: Pro
                  credits: 10000
                  created_at: 1704067200
                allow_usage: true
        '402':
          description: Ungültiger API-Schlüssel.
        '500':
          description: Interner Serverfehler.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Server Error
      security:
        - Authorization: []
components:
  schemas:
    CreditsInfoResponse:
      type: object
      properties:
        credits:
          type: integer
          description: >-
            Gesamte verbleibende Guthaben über alle nicht abgelaufenen Lose
            hinweg.
        breakdown:
          type: array
          items:
            $ref: '#/components/schemas/CreditsBreakdownItem'
          description: Guthabeneinzelheiten pro Los.
        active_subscription:
          $ref: '#/components/schemas/ActiveSubscription'
        allow_usage:
          type: boolean
          description: Ob das Team noch Guthaben verbrauchen kann.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Maschinell lesbarer Fehlercode.
        retry_after:
          type: integer
          description: >-
            Sekunden, bis ein weiterer Kaufversuch erlaubt ist (nur bei
            Abkühlungsantworten).
        cooldown_seconds:
          type: integer
          description: Abkühlungszeitfenster in Sekunden (nur für Abkühlungsantworten).
    CreditsBreakdownItem:
      type: object
      properties:
        purchase_kind:
          type: string
          enum:
            - Subscription
            - Top-up
            - Manual
            - Setup
            - Pending
          description: Wie das Guthabenlos ausgegeben wurde.
        allocated_units:
          type: integer
          description: Ursprünglich diesem Los zugewiesene Guthaben.
        remaining_units:
          type: integer
          description: Noch verfügbare Guthaben in diesem Los.
        expiry_date:
          type: integer
          description: Unix-Zeitstempel, wann dieses Los abläuft.
    ActiveSubscription:
      type: object
      properties:
        id:
          type: string
          description: >-
            Abonnement-Produkt-ID (zum Beispiel `SUB_PRO`). Fällt auf `SUB_BASE`
            zurück, wenn kein aktives Abonnement existiert.
        display_name:
          type: string
          description: Menschlich lesbarer Planname.
        credits:
          type: integer
          description: Guthaben, die im aktiven Plan enthalten sind.
        created_at:
          type: integer
          description: Unix-Zeitstempel, wann das Abonnement erstellt wurde.
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Bearer-Authentifizierungsheader in der Form Bearer <token>, wobei
        <token> dein Authentifizierungstoken ist.

````