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

> Saldo de la cuenta e historial de transacciones en v3.

El módulo Consultas permite consultar el saldo de la cuenta del business autenticado y el historial de transacciones para conciliación. Obtén un token con [POST /v3/auth/login](https://docs.mesadepagos.com/v3/auth.md) y envía `Authorization: Bearer {accessToken}` en cada request.

## Saldo de la cuenta

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

### Respuesta: HTTP 200

```json theme={null}
{
  "fiat": "BOB",
  "available": 1000,
  "accounting": 1200,
  "held": 200,
  "lastCredit": "2026-05-12T12:00:00.000Z",
  "lastDebit": "2026-05-12T12:00:00.000Z"
}
```

| Campo | Descripción |
| - | - |
| `fiat` | Moneda fiat de la cuenta, por ejemplo `BOB`. |
| `available` | Saldo disponible para operar. |
| `accounting` | Saldo contable, incluidos los fondos aún no liberados. |
| `held` | Saldo retenido, no disponible para operar. |
| `lastCredit` | Fecha del último crédito, o `null` si no hay créditos. |
| `lastDebit` | Fecha del último débito, o `null` si no hay débitos. |

La respuesta de saldo v3 es un único objeto de cuenta. Usa `available`, `accounting` y `held`; el array de saldos por producto de v2 tiene un contrato diferente. HTTP `400` indica que falta configurar la cuenta o que el request es inválido, `401` indica un fallo de autenticación y `503` indica que no se pudo consultar el saldo.

Consulta la [referencia API de saldo](https://docs.mesadepagos.com/v3/api-reference/consultas/balance.md).

## Historial de Transacciones

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

El historial mantiene el contrato de request y response de v2. La paginación usa `page=1` y `limit=10` por defecto. Una consulta exitosa devuelve HTTP `200`.

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

El filtro `type` acepta `deposit_virtual_account` para consultar cobros de cuentas virtuales. Las transacciones de ese tipo también pueden aparecer en el historial sin filtro, con `type: "deposit_virtual_account"`. `amountFiat` y `fiatCode` pueden ser `0` y `N/A` mientras llega la información del proveedor; consulta de nuevo más tarde para obtener los valores actualizados. Los cobros ACH de cuentas virtuales ATC incluyen además `achNumber` y `recipientNumber` cuando el proveedor los informa; en los demás tipos estos campos no se envían.

### 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
  }
}
```

Consulta la [referencia API del historial](https://docs.mesadepagos.com/v3/api-reference/consultas/historial-de-transacciones.md) para los filtros aceptados y los esquemas de respuesta. Usa el historial junto con [Webhooks v3](https://docs.mesadepagos.com/v3/webhooks.md) para conciliar las notificaciones de estado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.