> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/api-de-anunzi/v1/credits.md).

# Créditos

Saldo y movimientos de tu cuenta. Para **partners**, además, asignar y recuperar créditos de tus clientes. Base: `https://panel.anunzi.net/api/v1/credits/`.

| Método | Ruta           | Descripción                                                      |
| ------ | -------------- | ---------------------------------------------------------------- |
| `GET`  | `balance.php`  | Saldo de la cuenta (plan, recarga, total, y pool si es partner). |
| `GET`  | `ledger.php`   | Movimientos de créditos (paginado).                              |
| `GET`  | `clients.php`  | *(Partner)* Tus clientes con su saldo.                           |
| `POST` | `allocate.php` | *(Partner)* Asigna créditos de tu pool a un cliente.             |
| `POST` | `reclaim.php`  | *(Partner)* Recupera créditos no usados de un cliente.           |

***

## Saldo

```bash
curl "https://panel.anunzi.net/api/v1/credits/balance.php" \
  -H "Authorization: Bearer anz_live_TU_API_KEY"
```

Devuelve `{ "plan": N, "recarga": N, "total": N }` (y `"pool"` si eres partner).

## Asignar créditos a un cliente *(partner)*

```json
POST allocate.php
{ "client_user_id": 456, "amount": 1000, "note": "Alta mensual" }
```

Descuenta de tu pool y acredita al cliente. Devuelve el pool restante. El cliente debe pertenecer a tu cuenta partner.

## Recuperar créditos de un cliente *(partner)*

```json
POST reclaim.php
{ "client_user_id": 456, "amount": 500 }
```

Solo recupera hasta el saldo actual del cliente.

## Movimientos

`GET /api/v1/credits/ledger.php?limit=50` → lista de asientos (`amount`, `kind`, `note`, `created_at`).