---
title: "Get an order execution by ID"
method: GET
path: "/orders/{order_id}/executions/{execution_id}"
tags: ["Orders"]
---

# Get an order execution by ID

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

Returns the order execution specified by its ID. An execution represents a single trade fill within an order; an order may have multiple executions if it is partially filled across several trades.

See the Orders guide ([TOL](https://docs.upvest.co/products/tol/guides/orders) / [BYOL](https://docs.upvest.co/products/byol/guides/orders) / [Omnibus](https://docs.upvest.co/products/omnibus/guides/orders)) for execution lifecycle details.

## Response `200`

OK

- object — Represents a single execution (trade fill) within an order. An order may have multiple executions if it is partially filled across several trades.
  - `id` string, uuid, required
  - `cash_amount` string, required
  - `share_quantity` string, required
  - `price` string, required — Price of an instrument for a trade execution provided as a decimal string.
  - `transaction_time` string, date-time, required — Timestamp of when the trade was executed at the market. [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) date-time format.
  - `taxes` object[], required — Taxes deducted as part of this execution.
    - `type` 'TOTAL', required — Tax type * TOTAL -
    - `amount` string, required
  - `order_id` string, uuid, required — Unique identifier for an order. Universally Unique Identifier (UUID).
  - `status` 'FILLED' | 'SETTLED' | 'CANCELLED', required — Status of the execution. * FILLED — the execution has been filled. * SETTLED — the execution has settled and securities and cash have been exchanged. * CANCELLED — the execution was cancelled before settlement.
  - `side` 'BUY' | 'SELL', required — Side of the execution. * BUY — a buy execution. * SELL — a sell execution.
  - `currency` 'EUR' | 'GBP' | 'USD', required — Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR - Euro * GBP - British Pound * USD - US Dollar
  - `settlement_date` string — Order execution settlement date in the YYYY-MM-DD format. [RFC 3339, section 5.6](https://json-schema.org/draft/2020-12/json-schema-validation.html#RFC3339) RFC 3339
  - `venue_id` string, uuid, required — The ID of the venue

## Other responses

- `401` — Unauthorized. The caller has not been authenticated.
- `403` — Forbidden. The caller has been authenticated but is not allowed to take the requested action.
- `404` — Not Found. The requested resource could not be found.
- `406` — Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
- `429` — Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
- `500` — Internal Server Error. The service encountered an unexpected error.
- `503` — Service Unavailable. The service handling for this request cannot be reached at this time.
- `504` — Gateway Timeout. The service gateway has reached its internal timeout.

---

[API](https://skmtc.dev/upvest/apis/upvest-investment-api.md) · [All operations](https://skmtc.dev/upvest/apis/upvest-investment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upvest/upvest-investment-api/revisions/f6ee5fcc0337/schema)