---
title: "Retrieve Trade Allocation"
method: GET
path: "/managed/allocations/{allocationID}"
tags: ["Trade Allocations"]
---

# Retrieve Trade Allocation

`GET /managed/allocations/{allocationID}`

Retrieves Trade Allocation by allocationID.

## Path parameters

- `allocationID` string, required

## Response `200`

Retrieving Trade Allocation by allocationID was Successful.

- AllocationDetails
  - `id` string — The unique allocationID associated with a specific allocation.
  - `status` 'NEW' | 'ACCEPTED' | 'PART_COMPLETE' | 'COMPLETE' | 'REJECTED' — Overall status of an allocation.
  - `clientListID` string — An advisor created identifier for a specific allocation.
  - `accountID` string — The account identifier for the RIA master trading account.
  - `accountNo` string — The account number for the RIA master trading account.
  - `createdWhen` string — Date and time of allocation creation.
  - `allocations` AllocationDetailObject[] — An array of allocation objects that hold details of the allocation.
    - `accountID` string — The account identifier for an end user associated with an allocation.
    - `accountNo` string — The account number of an end user associated with an allocation.
    - `status` 'NEW' | 'FILLED' | 'REJECTED' — The status of the allocation.
    - `instrumentID` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `side` 'B' | 'S' | 'BUY_OPEN' | 'BUY_CLOSE' | 'SELL_OPEN' | 'SELL_CLOSE' — The side of the order.
    - `clientComment` string — A note for the type of allocation happening.
    - `qtyRequested` number — Quantity of shares requested to allocate to a users account.
    - `qtyAllocated` number — Quantity of shares allocated to a users account.
    - `avgPx` number — The average price of the security being allocated.
    - `fees` Fees — The fees associated with an allocation.
      - `total` number — The sum of all fees.
      - `sec` number — The Securities and Exchange Commission Fee.
      - `taf` number — The Trading Activity Fees.
      - `commission` number — The commissions for the allocation
      - `other` number — Any miscellaneous fees associated with the allocation.
  - `comment` string — A note created by the RIA upon creating an allocation.

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)