Retrieving orders

Retrieving an order by ID

You can retrieve an individual order by sending

GET /orders/{order_id}

Retrieving an order execution by ID

You can retrieve individual order executions via

GET /orders/{order_id}/executions/{execution_id}

Hence, the executions array for the above order looks as follows:

Example response

{
  "id": "eb5ba93f-5dfe-4bf1-8571-4da0caacc80c",
  "created_at": "2021-07-21T14:10:00.00Z",
  "updated_at": "2021-07-21T14:10:00.00Z",
  "user_id": "2dedfeb0-58cd-44f2-ae08-0e41fe0413d9",
  "account_id": "debf2026-f2da-4ff0-bb84-92e45babb1e3",
  "cash_amount": "1000",
  "currency": "EUR",
  "side": "BUY",
  "instrument_id": "US0378331005",
  "instrument_id_type": "ISIN",
  "order_type": "MARKET",
  "quantity": "0",
  "user_instrument_fit_acknowledgement": true,
  "limit_price": "",
  "stop_price": "",
  "status": "FILLED",
  "fee": "0.0",
  "executions": [
    {
      "id": "b9dc0676-8a7d-412d-802a-3b325eefd15e",
      "side": "BUY",
      "currency": "EUR",
      "status": "FILLED",
      "order_id":  "eb5ba93f-5dfe-4bf1-8571-4da0caacc80c",
      "cash_amount": "1000",
      "share_quantity": "11.734334663",
      "price": "85.22",
      "transaction_time": "2021-07-21T14:10:00.020Z",
      "taxes": [
        {
          "type": "TOTAL",
          "amount": "0"
        }
      ],
      "venue_id": "20d6024b-2df4-41ae-8d42-62e4744e455b"
    }
  ],
  "client_reference": "",
  "initiation_flow": "API"
}

Once the order executions are settled (typically on T+2) you will also receive an order execution SETTLED webhook. For sell orders, this means that the cash can now be withdrawn (see example 2).

To see what the respective webhooks for cash balance and positions updates look like, please go to the API References for cash balance events and positions events.