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

# Obtenir les crédits de l’organisation

> Renvoie le solde actuel de l’organisation.



## OpenAPI

````yaml fr/api-reference/openapi.json get /api/v1/credits/organization
openapi: 3.1.0
info:
  title: API AthenaHQ
  description: >-
    L’API AthenaHQ permet de gérer vos sites et prompts par programme pour
    l’optimisation de contenu par IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Serveur de production
security:
  - apiKey: []
tags:
  - name: Basics
    description: Opérations API principales pour gérer sites et prompts
  - name: Metrics
    description: Points de terminaison de métriques et analyses de visibilité IA
  - name: Billing
    description: Points de facturation et crédits pour gérer la consommation
  - name: Team Management
    description: Points de terminaison de gestion des membres et invitations
  - name: Groups
    description: Points de terminaison de gestion des groupes de sites
  - name: Content
    description: >-
      Points de terminaison Content Hub : onglets, URL suivies et détail des
      prompts par URL.
  - name: Pitch Workspace
    description: >-
      Points de terminaison des rapports Pitch Workspace : exécutions à
      l’échelle de l’organisation avec concurrents, prompts, attributs et
      métriques agrégées.
  - name: Knowledge Base
    description: >-
      Endpoints de lecture de la base de connaissances de la marque — faits
      approuvés et piliers qui les organisent.
paths:
  /api/v1/credits/organization:
    get:
      tags:
        - Billing
      summary: Obtenir les crédits de l’organisation
      description: Renvoie le solde actuel de l’organisation.
      operationId: getOrganizationCredits
      responses:
        '200':
          description: Réponse réussie avec le solde de crédits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreditsResponse'
              example:
                credits:
                  total: 5000
                  monthly:
                    balance: 5000
                    next_reset_at: 1772227690021
                  one_off:
                    balance: 0
        '401':
          description: Non autorisé — clé API invalide ou absente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Failed to fetch credits
      security:
        - apiKey: []
components:
  schemas:
    CreditsResponse:
      type: object
      description: Réponse de solde de crédits
      required:
        - credits
      properties:
        credits:
          type: object
          required:
            - total
            - monthly
            - one_off
          properties:
            total:
              type: integer
              description: Solde total de crédits, mensuels et ponctuels
              example: 700
            monthly:
              type: object
              description: Crédits mensuels récurrents
              required:
                - balance
                - next_reset_at
              properties:
                balance:
                  type: integer
                  description: Solde mensuel actuel de crédits
                  example: 700
                next_reset_at:
                  type: integer
                  description: >-
                    Horodatage en millisecondes de réinitialisation des crédits
                    mensuels
                  example: 1772227690021
            one_off:
              type: object
              description: Crédits achetés ponctuellement
              required:
                - balance
              properties:
                balance:
                  type: integer
                  description: Solde actuel des crédits ponctuels
                  example: 0
    Error:
      type: object
      description: Objet de réponse d’erreur
      required:
        - error
      properties:
        error:
          type: string
          description: Message expliquant l’erreur
          example: Unauthorized
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clé API d’authentification. Créez-en une
        [ici](https://app.athenahq.ai/organization?tab=api).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.