Cuentas bancarias
POST
Listar cuentas bancarias
POST /api/bank-accounts/list-bank-accounts
Descripción
Lista paginada de cuentas bancarias del restaurante.
Detalles
Devuelve las cuentas bancarias registradas con su nombre, entidad y subtipo. Soporta búsqueda libre por nombre o banco y ordenamiento. Incluye cuentas pausadas para permitir su reactivación.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | asc |
| withTotal | true |
| allowedSorts | [name, bankName, accountSubtype] |
Ejemplo de request
curl -X POST https://app.restofy.co/api/bank-accounts/list-bank-accounts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"limit": 200
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"bankAccounts": [
{
"bankAccountId": 7,
"accountId": 25,
"name": "Banco general",
"bankName": "Banco",
"accountNumber": "0000000000",
"accountHolder": "Tenant",
"accountSubtype": "checking",
"isActive": 1,
"currentBalanceCents": 0
},
{
"bankAccountId": 9101,
"accountId": 9101,
"name": "Bancolombia cuenta principal",
"bankName": "Bancolombia",
"accountNumber": "69100012345",
"accountHolder": "Sazon Restaurante SAS",
"accountSubtype": "checking",
"isActive": 1,
"currentBalanceCents": 1850000000
},
{
"bankAccountId": 1,
"accountId": 18,
"name": "Datáfono / Terminal POS",
"bankName": "Datáfono",
"accountNumber": "0000000000",
"accountHolder": "Tenant",
"accountSubtype": "checking",
"isActive": 1,
"currentBalanceCents": 0
},
{
"bankAccountId": 9102,
"accountId": 9102,
"name": "Davivienda ahorros",
"bankName": "Davivienda",
"accountNumber": "00480098765",
"accountHolder": "Sazon Restaurante SAS",
"accountSubtype": "savings",
"isActive": 1,
"currentBalanceCents": 920000000
},
{
"bankAccountId": 9103,
"accountId": 9103,
"name": "Tarjeta de credito BBVA",
"bankName": "BBVA",
"accountNumber": "45567788",
"accountHolder": "Sazon Restaurante SAS",
"accountSubtype": "credit",
"isActive": 0,
"currentBalanceCents": 0
}
],
"pagination": {
"page": 1,
"limit": 100,
"total": 5,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}