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

# Obtenir les informations de crédit

> Retourne le solde de crédit de l’équipe authentifiée, la répartition par lot, l’abonnement actif et si l’utilisation est autorisée.

Pour un aperçu guidé, voir [Solde & facturation](/balance-billing/balance-and-billing).


## OpenAPI

````yaml fr/openapi/billing.json GET /user/credits/info
openapi: 3.0.3
info:
  title: API de Solde & Facturation
  version: 1.0.0
  description: Lis le solde de crédit et achète des recharges pour l'équipe authentifiée.
servers:
  - url: https://api.olostep.com
security: []
tags:
  - name: Balance & Billing
    description: Points de terminaison pour le solde de crédit et l'achat de recharges.
paths:
  /user/credits/info:
    get:
      tags:
        - Balance & Billing
      summary: Obtenir des informations sur le crédit
      description: >-
        Retourne le solde de crédit de l'équipe authentifiée, la répartition par
        lot, l'abonnement actif et si l'utilisation est autorisée. Utile pour
        les widgets de facturation, les tableaux de bord d'utilisation et les
        vérifications préalables avant les gros travaux.
      responses:
        '200':
          description: >-
            Solde de crédit et contexte de facturation pour l'équipe
            authentifiée.
          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: Clé API invalide.
        '500':
          description: Erreur interne du serveur.
          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: Total des crédits restants sur tous les lots non expirés.
        breakdown:
          type: array
          items:
            $ref: '#/components/schemas/CreditsBreakdownItem'
          description: Détail des crédits par lot.
        active_subscription:
          $ref: '#/components/schemas/ActiveSubscription'
        allow_usage:
          type: boolean
          description: Si l'équipe peut encore consommer des crédits.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Code d'erreur lisible par la machine.
        retry_after:
          type: integer
          description: >-
            Secondes avant qu'une autre tentative d'achat soit autorisée
            (réponses de refroidissement uniquement).
        cooldown_seconds:
          type: integer
          description: >-
            Fenêtre de refroidissement en secondes (réponses de refroidissement
            uniquement).
    CreditsBreakdownItem:
      type: object
      properties:
        purchase_kind:
          type: string
          enum:
            - Subscription
            - Top-up
            - Manual
            - Setup
            - Pending
          description: Comment le lot de crédits a été émis.
        allocated_units:
          type: integer
          description: Crédits initialement alloués à ce lot.
        remaining_units:
          type: integer
          description: Crédits encore disponibles dans ce lot.
        expiry_date:
          type: integer
          description: Horodatage Unix quand ce lot expire.
    ActiveSubscription:
      type: object
      properties:
        id:
          type: string
          description: >-
            ID du produit d'abonnement (par exemple `SUB_PRO`). Revient à
            `SUB_BASE` lorsqu'aucun abonnement actif n'existe.
        display_name:
          type: string
          description: Nom du plan lisible par l'homme.
        credits:
          type: integer
          description: Crédits inclus dans le plan actif.
        created_at:
          type: integer
          description: Horodatage Unix quand l'abonnement a été créé.
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        En-tête d'authentification Bearer sous la forme Bearer <token>, où
        <token> est ton jeton d'authentification.

````