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

# Obtener saldo de créditos del equipo

> Obtén el saldo actual de créditos de tu equipo, incluidos los créditos de prompt por licencia, los créditos adicionales y la información sobre el ciclo de facturación.

<div id="overview">
  ## Descripción general
</div>

Obtén la información del saldo actual de créditos de tu equipo. Esto incluye los créditos de prompt asignados por licencia, el número de licencias, el uso de créditos adicionales y las fechas del ciclo de facturación.

<Warning>
  **Este endpoint solo refleja el ciclo de facturación actual.** No devuelve el uso histórico de ciclos anteriores.

  En particular, `addOnCreditsAvailable` **no** es un total histórico acumulado; se vuelve a calcular al inicio de cada ciclo de facturación en función de lo que se consumió en el ciclo anterior, por lo que el valor que ves cambiará mes a mes. Si tu equipo usó créditos adicionales en el ciclo anterior, `addOnCreditsAvailable` al inicio de este ciclo será menor que la cantidad que compraste originalmente.
</Warning>

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

<ParamField body="service_key" type="string" required>
  Tu clave de servicio con el permiso "Billing Read"
</ParamField>

<div id="example-request">
  ### Ejemplo de solicitud
</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">
  ## Respuesta
</div>

<ResponseField name="promptCreditsPerSeat" type="integer">
  Número de créditos de prompt asignados por licencia para el ciclo de facturación actual
</ResponseField>

<ResponseField name="numSeats" type="integer">
  Número de licencias del equipo
</ResponseField>

<ResponseField name="addOnCreditsAvailable" type="integer">
  Créditos adicionales disponibles para el equipo **solo en el ciclo de facturación actual**. Este valor se vuelve a calcular al inicio de cada ciclo de facturación en función del uso del ciclo anterior, por lo que cambia de un mes a otro y no representa el total histórico de créditos adicionales comprados.
</ResponseField>

<ResponseField name="addOnCreditsUsed" type="integer">
  Créditos adicionales consumidos hasta ahora **solo en el ciclo de facturación actual**. Este contador se reinicia al inicio de cada nuevo ciclo y no incluye el uso de ciclos anteriores.
</ResponseField>

<ResponseField name="billingCycleStart" type="string">
  Inicio del ciclo de facturación actual (marca temporal ISO 8601)
</ResponseField>

<ResponseField name="billingCycleEnd" type="string">
  Fin del ciclo de facturación actual (marca temporal ISO 8601)
</ResponseField>

<div id="example-response">
  ### Ejemplo de respuesta
</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">
  ## Respuestas de error
</div>

Escenarios de error comunes:

* Clave de servicio no válida o permisos insuficientes
* Funcionalidad no disponible en tu plan (requiere el nivel Enterprise)
* Se superó el límite de tasa