Obtener saldos de cuentas

Obtiene el saldo de dólar MEP para una o más cuentas de cliente.

POST/v1/operations/usd-mep/balances

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

No aplica: Path Parameters, Query Parameters.

Body

Campo	Tipo	Requerido	Descripción
client_account_numbers	array of strings	Sí	Números de cuenta de cliente para los que se desea obtener el saldo de dólar MEP. Cada cuenta debe pertenecer a quien realiza la solicitud y no debe estar bloqueada ni anulada.

Response

2XX Éxito

Campo	Tipo	Descripción
balances	array of objects	Lista de saldos por cuenta.
balances[].client_account_number	string	Número de cuenta de cliente.
balances[].balance_usd_mep	number	Saldo de dólar MEP disponible para la cuenta.
executed_at	string (datetime ISO 8601)	Marca de tiempo en la que se obtuvieron los saldos.

Códigos de error

Status	Descripción
400	Bad Request — una cuenta no pertenece a quien realiza la solicitud, o está bloqueada o anulada
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
500	Internal Server Error

Estructura del error:

{
  "code": "BAD_REQUEST",
  "description": "account does not belong to user or is blocked/annulled"
}

Ejemplo de código

cURL

curl -X POST https://b2b.allaria.cloud/v1/operations/usd-mep/balances \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_account_numbers": ["12345", "67890"]
  }'

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/operations/usd-mep/balances', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    client_account_numbers: ['12345', '67890']
  })
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.post(
  'https://b2b.allaria.cloud/v1/operations/usd-mep/balances',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'client_account_numbers': ['12345', '67890']
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://b2b.allaria.cloud/v1/operations/usd-mep/balances',
  { client_account_numbers: ['12345', '67890'] },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);
console.log(response.data);

2XX Éxito

{
  "balances": [
    { "client_account_number": "12345", "balance_usd_mep": 5230.75 },
    { "client_account_number": "67890", "balance_usd_mep": 1200.00 }
  ],
  "executed_at": "2026-07-21T09:00:00"
}