Get operations by account

Returns a paginated list of market operations (mutual fund operations, market orders, repo orders and MEP operations) registered for a given account.

You can filter by type, state, date range, settlement period and currency.

GET/v1/broker/operations/{account-id}

Request

Headers

Field	Type	Required	Description
Authorization	string	Yes	Access token in Bearer ACCESS_TOKEN format

Path Parameters

Field	Type	Required	Description
account-id	integer	Yes	Account number to fetch operations for.

Query Parameters

Field	Type	Required	Description
type	array of strings	No	Filter by instrument/operation subtype. Repeat the parameter to pass multiple values (e.g. type=BONDS&type=CEDEARS). Possible values: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
state	array of strings	No	Filter by operation state. Repeat the parameter to pass multiple values. Possible values: PENDING, PARTIALLY_FILLED, FILLED, PARTIALLY_CANCELLED, REJECTED, CANCELLED.
from	string (date)	No	Start date of the range (inclusive), in yyyy-MM-dd format.
to	string (date)	No	End date of the range (inclusive), in yyyy-MM-dd format.
settledPeriod	array of strings	No	Filter by settlement period. Repeat the parameter to pass multiple values. Possible values: T0, T1.
currency	array of strings	No	Filter by currency. Repeat the parameter to pass multiple values. Possible values: ARS, DOLLAR_MEP, DOLLAR_CCL.
page	integer	No	Page number (0-based). Default: 0.
size	integer	No	Number of results per page. Default: 20.

Not applicable: Body.

Response

2XX Success

Only one nested object is populated per record

Each entry in data represents one operation. Only one of fund, order or mep_operation is populated, depending on type — the other two are null:

type	Populated object
FUND	fund
ORDER or REPO_ORDER	order
MEP_OPERATION	mep_operation

Field	Type	Description
data	array of objects	List of operations matching the requested filters, for the current page.
data[].id	integer	Internal identifier of the operation.
data[].type	string	Operation type. Possible values: FUND, ORDER, REPO_ORDER, MEP_OPERATION.
data[].email	string	Email of the user that requested the operation.
data[].fund	object	Mutual fund operation details. Present only when type is FUND; null otherwise.
data[].fund.user_id	integer	Identifier of the user that requested the operation.
data[].fund.fund_operation	string	Fund operation type. Possible values: SUBSCRIBE (subscription), RETRIEVE (redemption/withdrawal).
data[].fund.fund_code	string	Bloomberg identifier of the mutual fund.
data[].fund.fund_name	string	Full name of the mutual fund.
data[].fund.currency	string	Operation currency. Possible values: ARS, DOLLAR_MEP, DOLLAR_CCL.
data[].fund.account_number	integer	Account number the operation was executed for.
data[].fund.amount	number	Amount operated, in the fund's currency.
data[].fund.price_per_share	number	Price per share (cuotaparte) at the time the operation was settled. null until it is known.
data[].fund.shares	number	Number of shares (cuotapartes) involved in the operation. null until it is known.
data[].fund.total	boolean	Whether the operation applied to the full position instead of a specific amount.
data[].fund.settled_period	string	Settlement period. Possible values: T0, T1.
data[].fund.settlement_date	string (ISO 8601 datetime)	Date and time the operation is/was settled. null until it is known.
data[].fund.trade_date	string (ISO 8601 datetime)	Date and time the operation was traded. null until it is known.
data[].fund.created_at	string (ISO 8601 datetime)	Date and time the operation was created.
data[].fund.state	string	Fund operation state. Possible values: PENDING, EXECUTED, FILLED, FAILED, INSUFFICIENT_POSITION.
data[].order	object	Market order details. Present only when type is ORDER or REPO_ORDER; null otherwise.
data[].order.id	integer	Internal identifier of the order.
data[].order.type	string	Order type. Possible values: MARKET, LIMIT, STOP_LIMIT.
data[].order.quantity	number	Quantity of nominal values requested.
data[].order.executed_quantity	number	Quantity of nominal values actually executed.
data[].order.amount	number	Monetary amount requested.
data[].order.symbol	string	Ticker of the instrument operated.
data[].order.market	string	Market the order was routed to (e.g. byma).
data[].order.side	string	Operation side. Possible values: BUY, SELL.
data[].order.currency	string	Currency of the order. Possible values: ARS, DOLLAR_MEP, DOLLAR_CCL.
data[].order.settled_period	string	Settlement period. Possible values: T0, T1.
data[].order.executed_amount	number	Monetary amount actually executed.
data[].order.executed_price	number	Price at which the order was executed.
data[].order.account_number	integer	Account number the order belongs to.
data[].order.state	string	Current order state. Possible values: SENT_TO_MARKET, PENDING, FILLED, CANCELLED, REJECTED, ERROR.
data[].order.user_id	integer	Identifier of the user who placed the order.
data[].order.operation_sub_type	string	Instrument category. Possible values: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
data[].order.created_at	string (ISO 8601 datetime)	Timestamp when the order was created.
data[].order.market_order_estimated_price	number	Reference price estimated at the time the order was placed.
data[].order.allaria_fee	number	Allaria fee charged for the order.
data[].order.byma_fee	number	BYMA fee charged for the order.
data[].order.allaria_fee_percentage	number	Allaria fee percentage applied.
data[].order.allaria_min_fee	number	Minimum Allaria fee applied.
data[].order.net_amount	number	Net amount for the order, including fees. Only populated once the order reaches state FILLED.
data[].order.repo_future_gross_amount	number	Gross amount to be settled at maturity. Only populated for repo orders (cauciones).
data[].order.repo_future_net_amount	number	Net amount to be settled at maturity, after fees. Only populated for repo orders (cauciones).
data[].order.oms_client_id	string	Identifier assigned to the order by the order management system (OMS).
data[].order.has_been_edited	boolean	Whether the order has been edited at least once.
data[].order.error_description	string	Description of the error, if the order ended in state ERROR.
data[].mep_operation	object	MEP operation details. Present only when type is MEP_OPERATION; null otherwise.
data[].mep_operation.id	string	External ID of the MEP operation.
data[].mep_operation.account_id	string	Client account number the operation belongs to.
data[].mep_operation.amount_in_ars	number	Total amount of the operation in ARS.
data[].mep_operation.amount_in_usd	number	Total amount of the operation in USD.
data[].mep_operation.state	string	Current state of the MEP operation. Possible values: SENT_TO_OMS_TO_BUY, BOND_BOUGHT, SENT_TO_OMS_TO_SELL, BOND_SOLD, CANCELLED, UNKNOWN, REJECTED_BUY, REJECTED_SELL, COMPLETED, PENDING.
data[].mep_operation.transact_time_buy	string (ISO 8601 datetime)	Execution timestamp of the buy leg.
data[].mep_operation.transact_time_sell	string (ISO 8601 datetime)	Execution timestamp of the sell leg.
data[].mep_operation.executed_amount	number	Total amount actually executed.
data[].mep_operation.quantity	integer	Quantity of the instrument traded.
data[].mep_operation.net_amount	number	Net amount of the operation after fees.
data[].state	string	Current operation state. Possible values: PENDING, PARTIALLY_FILLED, FILLED, PARTIALLY_CANCELLED, REJECTED, CANCELLED.
data[].currency	string	Currency of the operation. Possible values: ARS, DOLLAR_MEP, DOLLAR_CCL.
data[].settled_period	string	Settlement period. Possible values: T0, T1.
data[].sub_type	string	Instrument/operation subtype. Possible values: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
data[].settlement_date	string (ISO 8601 date)	Settlement date of the operation, in yyyy-MM-dd format.
data[].tag	object	Optional key-value metadata attached to the operation.
total	integer	Total number of operations matching the filters.
page	integer	Current page number (0-based).
size	integer	Number of results per page.

Error Codes

Status	Description
400	Bad Request — invalid or missing parameters, or the account number is not accessible by the authenticated user
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": "invalid_request",
  "description": "Invalid account number: 70104"
}

Code Example

cURL

curl -X GET "https://b2b.allaria.cloud/v1/broker/operations/70104?type=BONDS&state=FILLED&from=2026-07-01&to=2026-07-21&page=0&size=20" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const accountId = 70104;

const params = new URLSearchParams();
params.append('type', 'BONDS');
params.append('state', 'FILLED');
params.append('from', '2026-07-01');
params.append('to', '2026-07-21');
params.append('page', '0');
params.append('size', '20');

const response = await fetch(
  `https://b2b.allaria.cloud/v1/broker/operations/${accountId}?${params}`,
  {
    method: 'GET',
    headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

Python

import requests

account_id = 70104

response = requests.get(
  f'https://b2b.allaria.cloud/v1/broker/operations/{account_id}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' },
  params={
    'type': 'BONDS',
    'state': 'FILLED',
    'from': '2026-07-01',
    'to': '2026-07-21',
    'page': 0,
    'size': 20
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const accountId = 70104;

const response = await axios.get(
  `https://b2b.allaria.cloud/v1/broker/operations/${accountId}`,
  {
    headers: { Authorization: 'Bearer ACCESS_TOKEN' },
    params: {
      type: 'BONDS',
      state: 'FILLED',
      from: '2026-07-01',
      to: '2026-07-21',
      page: 0,
      size: 20
    }
  }
);
console.log(response.data);

2XX Success

{
  "data": [
    {
      "id": 501234,
      "type": "ORDER",
      "email": "cliente@example.com",
      "fund": null,
      "order": {
        "id": 984512,
        "type": "MARKET",
        "quantity": 6.0,
        "executed_quantity": 6.0,
        "amount": null,
        "symbol": "AL30",
        "market": "byma",
        "side": "BUY",
        "currency": "ARS",
        "settled_period": "T0",
        "executed_amount": 4890.00,
        "executed_price": 815.00,
        "account_number": 70104,
        "state": "FILLED",
        "user_id": 4521,
        "operation_sub_type": "BONDS",
        "created_at": "2026-07-15T10:32:11",
        "market_order_estimated_price": 814.50,
        "allaria_fee": 24.45,
        "byma_fee": 2.93,
        "allaria_fee_percentage": 0.5,
        "allaria_min_fee": 100.00,
        "net_amount": 4917.38,
        "repo_future_gross_amount": null,
        "repo_future_net_amount": null,
        "oms_client_id": "OPX-000123456",
        "has_been_edited": false,
        "error_description": null
      },
      "mep_operation": null,
      "state": "FILLED",
      "currency": "ARS",
      "settled_period": "T0",
      "sub_type": "BONDS",
      "settlement_date": "2026-07-15",
      "tag": {}
    },
    {
      "id": 501235,
      "type": "FUND",
      "email": "cliente@example.com",
      "fund": {
        "user_id": 987654,
        "fund_operation": "SUBSCRIBE",
        "fund_code": "ALRRFIJA AR",
        "fund_name": "Allaria Renta Fija",
        "currency": "ARS",
        "account_number": 70104,
        "amount": 10000.00,
        "price_per_share": 1523.47,
        "shares": 6.5638,
        "total": false,
        "settled_period": "T0",
        "settlement_date": "2026-07-21T18:00:00",
        "trade_date": "2026-07-21T15:32:10",
        "created_at": "2026-07-21T15:32:10",
        "state": "EXECUTED"
      },
      "order": null,
      "mep_operation": null,
      "state": "PENDING",
      "currency": "ARS",
      "settled_period": "T0",
      "sub_type": "FUND",
      "settlement_date": "2026-07-21",
      "tag": {}
    },
    {
      "id": 501236,
      "type": "MEP_OPERATION",
      "email": "cliente@example.com",
      "fund": null,
      "order": null,
      "mep_operation": {
        "id": "b7e4f2a1-9c3d-4e5f-8a1b-2d3e4f5a6b7c",
        "account_id": "70104",
        "amount_in_ars": 1250000.50,
        "amount_in_usd": 1000.00,
        "state": "BOND_SOLD",
        "transact_time_buy": "2026-07-20T10:15:32",
        "transact_time_sell": "2026-07-20T10:16:05",
        "executed_amount": 1249800.00,
        "quantity": 1000,
        "net_amount": 998500.00
      },
      "state": "FILLED",
      "currency": "DOLLAR_MEP",
      "settled_period": "T0",
      "sub_type": "MEP_OPERATION",
      "settlement_date": "2026-07-20",
      "tag": { "reference": "op-001" }
    }
  ],
  "total": 3,
  "page": 0,
  "size": 20
}