---
title: "Saldo de la cuenta (cupo del plan + comprado)"
method: GET
path: "/v1/balance"
tags: ["Account"]
---

# Saldo de la cuenta (cupo del plan + comprado)

`GET /v1/balance`

## Request

- Base URL: `https://api.almanac.ar`
- URL: `https://api.almanac.ar/v1/balance`
- Auth: HTTP bearer

En lenguaje de cliente: cuántos informes nuevos y actualizaciones le quedan a la cuenta. El saldo no vence.

## Response `200`

Saldo.

- BalanceResponse
  - `cupo` object, required
    - `unidades_disponibles` integer, required
    - `informes_nuevos` integer, required: Cuántos informes NUEVOS alcanza este bolsillo (floor).
    - `actualizaciones` integer, required: Cuántas actualizaciones alcanza este bolsillo (floor).
    - `unidades_mensuales` integer, nullable, required: null = sin cupo automático definido (hoy team/enterprise, 'a convenir').
    - `unidades_usadas` integer, required
  - `comprado` object, required
    - `unidades_disponibles` integer, required
    - `informes_nuevos` integer, required: Cuántos informes NUEVOS alcanza este bolsillo (floor).
    - `actualizaciones` integer, required: Cuántas actualizaciones alcanza este bolsillo (floor).

## Other responses

- `401`: Sin sesión ni API key.
- `403`: Cuenta suspendida (requireAuth, cualquier ruta autenticada), o canal API no habilitado en el plan.
- `429`: rate_limited.

---

[API](https://skmtc.dev/almanac/apis/almanac-api.md) · [All operations](https://skmtc.dev/almanac/apis/almanac-api/llms.txt) · [OpenAPI document](https://skmtc.dev/almanac/apis/almanac-api/revisions/f1b8ffd54263?raw)