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

# Consultas

> Saldos e historial de transacciones.

El módulo Consultas permite revisar saldos e historial de transacciones para conciliación operativa.

## Payouts Balance

```http theme={null}
GET /v2/transactions/payouts/balance
```

### Response

```json theme={null}
[
  {
    "type": "withdrawal_ach",
    "balance": 1000,
    "fiat": "BOB",
    "lastCredit": "2026-05-12T12:00:00.000Z",
    "lastDebit": "2026-05-12T12:00:00.000Z"
  }
]
```

Si el proveedor de saldos no está disponible temporalmente, la API mantiene este contrato y devuelve los balances de Payout ACH y Payout QR en `0` hasta que la consulta pueda restablecerse.

## Historial de Transacciones

```http theme={null}
GET /v2/transactions/history
```

### Query Params

| Parámetro           | Requerido | Descripción            |
| ------------------- | --------- | ---------------------- |
| `type`              | No        | Tipo de transacción.   |
| `transactionStatus` | No        | Estado de transacción. |
| `page`              | No        | Página solicitada.     |
| `limit`             | No        | Registros por página.  |
| `fromDate`          | No        | Fecha inicial.         |
| `toDate`            | No        | Fecha final.           |
| `search`            | No        | Texto de búsqueda.     |

### Response

```json theme={null}
{
  "transactions": [
    {
      "amountFiat": 69.6,
      "amountCrypto": 10,
      "assetCode": "USDC",
      "fiatCode": "BOB",
      "exchangeRate": 6.96,
      "transactionId": "550e8400-e29b-41d4-a716-446655440000",
      "type": "deposit_express",
      "status": "completed_transaction",
      "createdAt": "2026-05-12T12:00:00.000Z",
      "updatedAt": "2026-05-12T12:00:00.000Z",
      "externalReference": "ORDER-1001"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}
```