# Query all trades on an order by ID

Get all fills for the order ID assigned by Integral returned in the  or  field when the order was placed.

Endpoint: GET /v2/trades
Version: 1.0.1
Security: SSO_TOKEN

## Query parameters:

  - `coId` (string, required)
    The unique ID assigned by you when your order was placed. Returned in response in the  field.
    Example: "OrderXEL278vv1"

  - `orderId` (string, required)
    The unique ID assigned by Integral when your order was placed. Returned in response in the  field.
    Example: "4820275011"

## Response 200 fields (application/json):

  - `orderId` (string)
    Order ID.

  - `tradeId` (string)
    Integral trade ID.

  - `tradeType` (string)
    Trade type:
- 
- 
- 
- 
- 
-

  - `tenor` (string)
    Trade tenor:
- : today
- : today
- : overnight (today)
- : tomorrow
- : spot
- : spot
- : spot next (spot+1)
- : a number of days after the current business date (for example, 1D, 2D, 10D)
- : a number of weeks after the current business date (for example, 1W, 2W, 3W)
- : a number of months after the current business date (for example, 1M, 2M, 3M)
- : a number of years after the current business date (for example, 1Y, 2Y, 3Y)
- : The next International Monetary Market (IMM) settlement date. IMM dates are the third Wednesday of the last month of every quarter (March, June, September, December).  results in the next IMM date on or after the spot date.  results in two IMM dates after the spot date.
- : (spot + IMM) for swaps
- : (tomorrow + IMM) for swaps

  - `tradeDate` (string)
    Date the trade was initiated in the format .

  - `valueDate` (string)
    Value date in the format .

  - `fixingDate` (string)
    (NDF trades) Fixing date in the format .

  - `fixingTenor` (string)
    (NDF trades) Fixing tenor.

  - `executionTime` (string)
    Date and time trade was done in the format .

  - `maker` (boolean)
    - : Maker (the deal was initiated by submitting a request or from working the balance on an outstanding order).
- : Taker (the deal was initiated by taking a dealable price in the app).

  - `orderSide` (string)
    Side of the order from your perspective, either  or .

  - `status` (string)
    Status of the trade when the message was created: 
- Pending
- Verified
- Rejected

  - `rejectReason` (string)
    The reason for trade rejection, if any.

  - `symbol` (string)
    Dealt instrument pair (currency, metal, energy, index, crypto), seven-character ISO code (for example, ).

  - `dealtIns` (string)
    Dealt instrument, three-character ISO code (for example, ).

  - `dealtAmount` (number)
    Amount of the dealt instrument or near-leg instrument.

  - `settledAmount` (number)
    Amount of the settlement instrument.

  - `baseAmount` (number)
    Amount of base instrument.

  - `termAmount` (number)
    Amount of term instrument.

  - `spotRate` (number)
    Spot rate of the trade or near leg of the trade.

  - `rate` (number)
    All-in rate.

  - `orderType` (string)
    Type of order.

  - `rateId` (string)
    ID of the originating rate, if any.

  - `forwardPoints` (number)
    Forward points for outright trades and near leg of swaps.

  - `swapPoints` (number)
    Swap points, if any.

  - `customerAccount` (string)
    Customer legal entity ID.

  - `customerOrg` (string)
    Customer org ID.

  - `trader` (string)
    Customer trader user who did the trade.

  - `counterparty` (string)
    Counterparty ID.

  - `cptyLongName` (string)
    Counterparty name.

  - `coverTradeIds` (array)
    List of ID for trades that cover this trade, if any.

  - `cptyTradeId` (string,null)
    Trade ID assigned by counterparty.

  - `counterpartyAccount` (string)
    Counterparty legal entity ID.

  - `channel` (string)
    Workflow, app, and UI component that originated the request.

  - `farTenor` (string)
    Far-leg tenor for swaps.

  - `farFixingTenor` (string)
    Far-leg fixing tenor for NDF swaps.

  - `farFixingDate` (string)
    Far-leg fixing date for NDF swaps in the format .

  - `farValueDate` (string)
    Far-leg value date for swaps in the format .

  - `farSide` (string)
    Side of the far leg for swaps.

  - `farRate` (number)
    Far-leg rate for swaps.

  - `farDealtAmount` (number)
    Far-leg amount in the dealt instrument for swaps.

  - `farSettledAmount` (number)
    Far-leg amount in the settlement instrument for swaps.

  - `farBaseAmount` (number)
    Far-leg amount in the base instrument for swap.

  - `farTermAmount` (number)
    Far-leg amount in the term instrument for swaps.

  - `farForwardPoints` (number)
    Far-leg forward points for swaps.

  - `counterpartyALEI` (string)
    LEI code for counterpartyA.

  - `counterpartyBLEI` (string)
    LEI code for counterpartyB.

  - `externalRequestId` (string)
    The ID of the originating request for price from a system external to Integral.

  - `requestId` (string)
    The ID of the originating request for price from Integral systems.

  - `portfolioId` (string)
    Containing portfolio ID for batch trades and SSPs.

  - `benchmarkRate` (number)
    Reference benchmark rate.

  - `outright` (object)
    Forward pricing info for the trade.

  - `outright.forwardPoints` (number)
    Forward points.

  - `outright.maturityDate` (string)
    Maturity date in the format .

  - `outright.spotRate` (number)
    Spot rate.

  - `outright.fixingTenor` (string)
    NDF fixing tenor, if any.

  - `outright.tenor` (string)
    Requested tenor, if any.

  - `outright.fixingDate` (string)
    NDF fixing date in the format .

  - `farLegISIN` (string)
    Far-leg International Securities Identification Number for multi-leg trades.

  - `nearLegISIN` (string)
    Near-leg International Securities Identification Number for multi-leg trades.

  - `regulatory` (object)
    An object containing regulatory information.

  - `regulatory.orderSubmissionTime` (string)
    Date and time of order submission.

  - `regulatory.tradeExecutionTime` (string)
    Date and time of trade execution.

  - `regulatory.mtf` (boolean)
    Whether or not the trade done in a multilateral trading facility.

  - `regulatory.mtfVenue` (string)
    ID of the MTF.

  - `regulatory.investmentDecisionMaker` (string)
    User ID of the investment decision maker.

  - `regulatory.takerCapacity` (string)
    Taker capacity represented by this trade.

  - `regulatory.executingUser` (string)
    ID of the executing user.

  - `regulatory.executingOrg` (string)
    ID of the executing organization.

  - `regulatory.makerExecutingFirm` (string)
    ID of the executing maker organization.

  - `regulatory.takerExecutingFirm` (string)
    ID of the executing taker organization.

  - `regulatory.siExecution` (boolean)
    Whether or not the trade done by a systemic internalizer.

  - `regulatory.siVenue` (string)
    The ID of the systemic internalizer venue.

  - `regulatory.sft` (boolean)
    Whether or not the trade is a securities financing transaction.

  - `regulatory.npft` (boolean)
    Whether or not the trade is a non-price forming transaction.

  - `regulatory.preTradeWaiver` (string)
    Pre-trade transparency waiver.

  - `regulatory.postTradeDeferral` (string)
    Post-trade deferral period.

  - `regulatory.takerCountryCode` (string)
    Taker organization’s country code.

  - `regulatory.makerCountryCode` (string)
    Maker organization’s country code.

  - `regulatory.customerCountryCode` (string)
    Customer’s country code.

  - `regulatory.customerAccount` (string)
    ID of the customer legal entity.

  - `regulatory.counterpartyALEI` (string)
    Counterparty A's Legal Entity Identifier for MiFID II.

  - `regulatory.counterpartyBLEI` (string)
    Counterparty B's Legal Entity Identifier for MiFID II.

  - `fees` (number)
    Fees on the trade, if any.

  - `initialSettledAmount` (number)
    The initial settled amount before any amendment.

  - `notes` (string)
    Any notes on the order entered by the order submitting user.

  - `midMarket` (boolean)
    Whether or not the trade was done at the mid-market rate.

  - `uti` (string)
    The Unique Trade Identifier if the trade was done in a SEF.

  - `upi` (string)
    The Unique Product Identifier if the trade was done in a SEF.

  - `isinLinkId` (string)
    International Securities Identification Number link ID.

  - `customParameters` (object)
    Collection of parameters that are unique to your organization. The number of parameters, their keynames, and values are defined by you.

Contact your Integral Technical Account Manager to enable and configure custom parameters.

Your custom parameters are included in API responses and in STP trade download.

Custom parameters sent to Integral via API are stored in the database directly. No validation is performed.

The maximum size of the  property is  characters, including all keys, values, and JSON syntax characters.

  - `customParameters.keyName` (string)
    The keyname of a custom parameter key/value pair as defined by your organization. Contact your Integral Technical Account Manager to enable and configure custom parameters.

  - `customParameters.value` (string)
    The value of a custom parameter key/value pair as defined by your organization. Contact your Integral Technical Account Manager to enable and configure custom parameters.