Get order by ID

Returns a single order identified by its internal order ID.

GET/v1/broker/orders/id/{order-id}

Request

Headers

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

Path Parameters

Field	Type	Required	Description
order-id	integer	Yes	Internal identifier of the order to fetch.

Not applicable: Query Parameters, Body.

Response

2XX Success

Field	Type	Description
id	integer	Internal identifier of the order.
type	string	Order type. Possible values: MARKET, LIMIT, STOP_LIMIT.
quantity	number	Quantity of nominal values requested.
executed_quantity	number	Quantity of nominal values actually executed.
amount	number	Monetary amount requested.
symbol	string	Ticker of the instrument operated.
market	string	Market the order was routed to (e.g. byma).
side	string	Operation side. Possible values: BUY, SELL.
currency	string	Currency of the order. Possible values: ARS, DOLLAR_MEP, DOLLAR_CCL.
settled_period	string	Settlement period. Possible values: T0, T1.
executed_amount	number	Monetary amount actually executed.
executed_price	number	Price at which the order was executed.
account_number	integer	Account number the order belongs to.
state	string	Current order state. Possible values: SENT_TO_MARKET, PENDING, FILLED, CANCELLED, REJECTED, ERROR.
user_id	integer	Identifier of the user who placed the order.
operation_sub_type	string	Instrument category. Possible values: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
created_at	string (ISO 8601 datetime)	Timestamp when the order was created.
market_order_estimated_price	number	Reference price estimated at the time the order was placed.
allaria_fee	number	Allaria fee charged for the order.
byma_fee	number	BYMA fee charged for the order.
allaria_fee_percentage	number	Allaria fee percentage applied.
allaria_min_fee	number	Minimum Allaria fee applied.
net_amount	number	Net amount for the order, including fees. Only populated once the order reaches state FILLED.
repo_future_gross_amount	number	Gross amount to be settled at maturity. Only populated for repo orders (cauciones).
repo_future_net_amount	number	Net amount to be settled at maturity, after fees. Only populated for repo orders (cauciones).
oms_client_id	string	Identifier assigned to the order by the order management system (OMS).
has_been_edited	boolean	Whether the order has been edited at least once.
error_description	string	Description of the error, if the order ended in state ERROR.

Error Codes

Status	Description
400	Bad Request — no order exists with the given order-id
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": "Order 984512 not found"
}

Code Example

cURL

curl -X GET https://b2b.allaria.dev/v1/broker/orders/id/984512 \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const orderId = 984512;

const response = await fetch(
  `https://b2b.allaria.dev/v1/broker/orders/id/${orderId}`,
  {
    method: 'GET',
    headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

Python

import requests

order_id = 984512

response = requests.get(
  f'https://b2b.allaria.dev/v1/broker/orders/id/{order_id}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const orderId = 984512;

const response = await axios.get(
  `https://b2b.allaria.dev/v1/broker/orders/id/${orderId}`,
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Success

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