> ## 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.

# Ottieni informazioni sui crediti

> Restituisce il saldo crediti del team autenticato, la suddivisione per lotto, l’abbonamento attivo e se l’uso è consentito.

Per una panoramica guidata, vedi [Saldo e fatturazione](/balance-billing/balance-and-billing).


## OpenAPI

````yaml it/openapi/billing.json GET /user/credits/info
openapi: 3.0.3
info:
  title: API Saldo & Fatturazione
  version: 1.0.0
  description: Leggi il saldo dei crediti e acquista ricariche per il team autenticato.
servers:
  - url: https://api.olostep.com
security: []
tags:
  - name: Balance & Billing
    description: Endpoint per saldo crediti e acquisto ricariche.
paths:
  /user/credits/info:
    get:
      tags:
        - Balance & Billing
      summary: Ottieni informazioni sul credito
      description: >-
        Restituisce il saldo del credito del team autenticato, la suddivisione
        per lotto, l'abbonamento attivo e se l'uso è consentito. Utile per
        widget di fatturazione, dashboard di utilizzo e controlli pre-volo prima
        di lavori di grandi dimensioni.
      responses:
        '200':
          description: >-
            Saldo del credito e contesto di fatturazione per il team
            autenticato.
          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: Chiave API non valida.
        '500':
          description: Errore interno del server.
          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: Totale crediti rimanenti in tutti i lotti non scaduti.
        breakdown:
          type: array
          items:
            $ref: '#/components/schemas/CreditsBreakdownItem'
          description: Dettaglio dei crediti per lotto.
        active_subscription:
          $ref: '#/components/schemas/ActiveSubscription'
        allow_usage:
          type: boolean
          description: Se il team può ancora consumare crediti.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Codice di errore leggibile dalla macchina.
        retry_after:
          type: integer
          description: >-
            Secondi fino a quando è consentito un altro tentativo di acquisto
            (solo risposte di cooldown).
        cooldown_seconds:
          type: integer
          description: Finestra di cooldown in secondi (solo risposte di cooldown).
    CreditsBreakdownItem:
      type: object
      properties:
        purchase_kind:
          type: string
          enum:
            - Subscription
            - Top-up
            - Manual
            - Setup
            - Pending
          description: Come è stato emesso il lotto di crediti.
        allocated_units:
          type: integer
          description: Crediti originariamente assegnati a questo lotto.
        remaining_units:
          type: integer
          description: Crediti ancora disponibili in questo lotto.
        expiry_date:
          type: integer
          description: Timestamp Unix quando questo lotto scade.
    ActiveSubscription:
      type: object
      properties:
        id:
          type: string
          description: >-
            ID prodotto dell'abbonamento (ad esempio `SUB_PRO`). Torna a
            `SUB_BASE` quando non esiste un abbonamento attivo.
        display_name:
          type: string
          description: Nome del piano leggibile dall'uomo.
        credits:
          type: integer
          description: Crediti inclusi nel piano attivo.
        created_at:
          type: integer
          description: Timestamp Unix quando l'abbonamento è stato creato.
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Intestazione di autenticazione Bearer del tipo Bearer <token>, dove
        <token> è il tuo token di autenticazione.

````