Ir al contenido

Balance (Colombia)

GET /v1/co/balance

Devuelve tu balance de la región Colombia, con el desglose por proveedor (NEQUI / BREB). Todos los montos en pesos COP enteros.

Response `200 OK`

{
  "clientId": "cli_abc123",
  "country": "CO",
  "currency": "COP",
  "totalBalance": 1250000,
  "holdBalance": 30800,
  "availableBalance": 1219200,
  "updatedAt": "2026-06-01T10:05:00.000Z",
  "providers": [
    {
      "provider": "NEQUI",
      "totalBalance": 800000,
      "holdBalance": 30800,
      "availableBalance": 769200,
      "txCount": 154
    },
    {
      "provider": "BREB",
      "totalBalance": 450000,
      "holdBalance": 0,
      "availableBalance": 450000,
      "txCount": 89
    }
  ]
}

Campo	Descripción
`totalBalance`	Balance total acreditado en pesos COP
`holdBalance`	Monto retenido por dispersiones en curso (`PROCESSING`)
`availableBalance`	Disponible para dispersar (`totalBalance - holdBalance`)
`updatedAt`	Última vez que se movió el balance
`providers[].provider`	`NEQUI` o `BREB`
`providers[].txCount`	Cantidad de transacciones que movieron balance con ese proveedor