Desarrolladores

Tesorería

Saldos de las cuentas bancarias por IBAN y divisa.

GET /tesoreria/accounts

Listar cuentas bancarias y saldos

Saldo agregado por IBAN y divisa de tu cuenta.

Permiso exigido: treasury:bank_accounts.read (Tesorería › Cuentas bancarias › Leer)

Paginación: Sin paginación: devuelve el conjunto completo.

Parámetros

NombreEnTipoDescripción
currencyquerystring
ibanquerystring
fromquerystring (date)
toquerystring (date)

Respuestas

200 Cuentas de tesorería · application/json

NombreTipoDescripción
accountsobject[]
accounts[].companyIdstring
accounts[].ibanstring
accounts[].currencystring
accounts[].balancenumberSuma de los movimientos en la divisa de la cuenta (2 decimales)
accounts[].movementCountinteger
accounts[].latestMovementstring (date)
puede ser null

401 Falta el token Bearer o no es válido. · application/json

NombreTipoDescripción
errorstringMensaje de error legible
required_permissionstringSolo en el 403: el permiso que falta (área:recurso.acción)

403 El token no tiene el permiso exigido o el recurso queda fuera de su alcance. · application/json

NombreTipoDescripción
errorstringMensaje de error legible
required_permissionstringSolo en el 403: el permiso que falta (área:recurso.acción)

429 Se ha alcanzado un límite de uso. · application/json

NombreTipoDescripción
errorstringMensaje de error legible
required_permissionstringSolo en el 403: el permiso que falta (área:recurso.acción)

Ejemplos

curl 
curl -X GET "https://app.bm.consulting/api/v1/tesoreria/accounts" \
  -H "Authorization: Bearer $BMC_TOKEN"
TypeScript (fetch) 
const res = await fetch("https://app.bm.consulting/api/v1/tesoreria/accounts", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.BMC_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
Python (requests) 
import os
import requests

res = requests.get(
    "https://app.bm.consulting/api/v1/tesoreria/accounts",
    headers={"Authorization": f"Bearer {os.environ['BMC_TOKEN']}"},
    timeout=30,
)
res.raise_for_status()
data = res.json()
Email
Contacto