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

# Recupera il saldo crediti del team

> Recupera l'attuale saldo crediti del tuo team, inclusi i crediti prompt per postazione, i crediti aggiuntivi e le informazioni sul ciclo di fatturazione.

<div id="overview">
  ## Panoramica
</div>

Recupera le informazioni sul saldo crediti attuale del tuo team. Include i crediti prompt allocati per postazione, il numero di postazioni, l'utilizzo dei crediti aggiuntivi e le date del ciclo di fatturazione.

<Warning>
  **Questo endpoint riflette solo il ciclo di fatturazione attuale.** Non restituisce i dati di utilizzo storici dei cicli precedenti.

  In particolare, `addOnCreditsAvailable` **non** è un totale complessivo nel tempo — viene ricalcolato all'inizio di ogni ciclo di fatturazione in base a quanto è stato consumato nel ciclo precedente, quindi il valore visualizzato cambierà di mese in mese. Se il tuo team ha utilizzato crediti aggiuntivi nel ciclo scorso, `addOnCreditsAvailable` all'inizio di questo ciclo sarà inferiore all'importo originariamente acquistato.
</Warning>

<div id="request">
  ## Richiesta
</div>

<ParamField body="service_key" type="string" required>
  La tua chiave di servizio con l'autorizzazione "Billing Read"
</ParamField>

<div id="example-request">
  ### Esempio di richiesta
</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">
  ## Risposta
</div>

<ResponseField name="promptCreditsPerSeat" type="integer">
  Numero di crediti prompt allocati per ogni postazione nel ciclo di fatturazione corrente
</ResponseField>

<ResponseField name="numSeats" type="integer">
  Numero di postazioni del team
</ResponseField>

<ResponseField name="addOnCreditsAvailable" type="integer">
  Crediti aggiuntivi disponibili per il team **solo per il ciclo di fatturazione corrente**. Questo valore viene ricalcolato all'inizio di ogni ciclo di fatturazione in base all'utilizzo del ciclo precedente, quindi varia di mese in mese e non rappresenta il totale cumulativo dei crediti aggiuntivi acquistati.
</ResponseField>

<ResponseField name="addOnCreditsUsed" type="integer">
  Crediti aggiuntivi consumati finora **solo nel ciclo di fatturazione corrente**. Questo contatore si azzera all'inizio di ogni nuovo ciclo e non include l'utilizzo dei cicli precedenti.
</ResponseField>

<ResponseField name="billingCycleStart" type="string">
  Inizio del ciclo di fatturazione corrente (timestamp ISO 8601)
</ResponseField>

<ResponseField name="billingCycleEnd" type="string">
  Fine del ciclo di fatturazione corrente (timestamp ISO 8601)
</ResponseField>

<div id="example-response">
  ### Esempio di risposta
</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">
  ## Risposte di errore
</div>

Scenari di errore comuni:

* Chiave di servizio non valida o autorizzazioni insufficienti
* Funzionalità non disponibile per il tuo piano (richiede il livello Enterprise)
* Limite di richieste superato