Get account balances

Retrieves the USD-MEP balance for one or more client accounts.

POST/v1/operations/usd-mep/balances

Request

Headers

Field	Type	Required	Description
Authorization	string	Yes	Access token in Bearer ACCESS_TOKEN format
Content-Type	string	Yes	Must be application/json

Not applicable: Path Parameters, Query Parameters.

Body

Field	Type	Required	Description
client_account_numbers	array of strings	Yes	Client account numbers to retrieve the USD-MEP balance for. Every account must belong to the caller and must not be blocked or annulled.

Response

2XX Success

Field	Type	Description
balances	array of objects	List of account balances.
balances[].client_account_number	string	Client account number.
balances[].balance_usd_mep	number	Available USD-MEP balance for the account.
executed_at	string (ISO 8601 datetime)	Timestamp when the balances were retrieved.

Error Codes

Status	Description
400	Bad Request — an account does not belong to the caller, or is blocked or annulled
401	Unauthorized — invalid or missing access token
403	Forbidden — the token does not have permission to access this resource
500	Internal Server Error

Error structure:

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

Code Example

cURL

curl -X POST https://b2b.allaria.dev/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.dev/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.dev/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.dev/v1/operations/usd-mep/balances',
  { client_account_numbers: ['12345', '67890'] },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);
console.log(response.data);

2XX Success

{
  "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"
}