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

# Obtenir le solde de crédits de la Team

> Récupérer le solde actuel de crédits de votre Team, y compris les crédits de prompt par siège, les crédits complémentaires et les informations sur le cycle de facturation.

<div id="overview">
  ## Vue d’ensemble
</div>

Récupérez les informations relatives au solde actuel de crédits de votre Team. Cela inclut les crédits de prompt alloués par siège, le nombre de sièges, l’utilisation des crédits complémentaires et les dates du cycle de facturation.

<Warning>
  **Cet endpoint reflète uniquement le cycle de facturation en cours.** Il ne renvoie pas l’utilisation historique des cycles précédents.

  En particulier, `addOnCreditsAvailable` n’est **pas** un total cumulé sur toute la durée — il est recalculé au début de chaque cycle de facturation en fonction de ce qui a été consommé pendant le cycle précédent. La valeur affichée changera donc d’un mois à l’autre. Si votre Team a utilisé des crédits complémentaires lors du cycle précédent, `addOnCreditsAvailable` au début du cycle en cours sera inférieur au montant que vous avez initialement acheté.
</Warning>

<div id="request">
  ## Requête
</div>

<ParamField body="service_key" type="string" required>
  Votre clé de service disposant des autorisations « Billing Read »
</ParamField>

<div id="example-request">
  ### Exemple de requête
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here"
}' \
https://server.codeium.com/api/v1/GetTeamCreditBalance
```

<div id="response">
  ## Réponse
</div>

<ResponseField name="promptCreditsPerSeat" type="integer">
  Nombre de crédits de prompt alloués par siège pour le cycle de facturation en cours
</ResponseField>

<ResponseField name="numSeats" type="integer">
  Nombre de sièges de la Team
</ResponseField>

<ResponseField name="addOnCreditsAvailable" type="integer">
  Crédits complémentaires disponibles pour la Team pour le **cycle de facturation en cours uniquement**. Cette valeur est recalculée au début de chaque cycle de facturation en fonction de l’utilisation du cycle précédent. Elle varie donc d’un mois à l’autre et ne correspond pas au total cumulé de tous les crédits complémentaires achetés.
</ResponseField>

<ResponseField name="addOnCreditsUsed" type="integer">
  Crédits complémentaires consommés jusqu’à présent dans le **cycle de facturation en cours uniquement**. Ce compteur est réinitialisé au début de chaque nouveau cycle et n’inclut pas l’utilisation des cycles précédents.
</ResponseField>

<ResponseField name="billingCycleStart" type="string">
  Début du cycle de facturation en cours (horodatage ISO 8601)
</ResponseField>

<ResponseField name="billingCycleEnd" type="string">
  Fin du cycle de facturation en cours (horodatage ISO 8601)
</ResponseField>

<div id="example-response">
  ### Exemple de réponse
</div>

```json theme={null}
{
  "promptCreditsPerSeat": 500,
  "numSeats": 50,
  "addOnCreditsAvailable": 10000,
  "addOnCreditsUsed": 3500,
  "billingCycleStart": "2026-01-01T00:00:00Z",
  "billingCycleEnd": "2026-02-01T00:00:00Z"
}
```

<div id="error-responses">
  ## Réponses d'erreur
</div>

Scénarios d'erreur courants :

* Clé de service invalide ou autorisations insuffisantes
* Fonctionnalité non disponible avec votre offre (niveau Enterprise requis)
* Limite de requêtes dépassée