## Get Executions

`$ clst v1:orders get-executions`

**get** `/v1/accounts/{account_id}/executions`

Retrieves filled and partially-filled execution reports for the specified
trading account, ordered by transaction time (nanosecond precision) descending.

### Parameters

- `--account-id: number`

  Account identifier

- `--from: optional string`

  The start date and time for the query range, inclusive (ISO 8601 format)

- `--instrument-id: optional string`

  Optional instrument to filter by. Accepts either a symbol (e.g. `AAPL`) or an OEMS instrument UUID.

- `--page-size: optional number`

  The number of items to return per page. Only used when page_token is not provided.

- `--page-token: optional string`

  Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

- `--to: optional string`

  The end date and time for the query range, inclusive (ISO 8601 format)

### Returns

- `V1OrderGetExecutionsResponse: BaseResponse`

  - `data: array of Execution`

    - `id: string`

      Unique identifier for this execution report.

    - `instrument_id: string`

      OEMS instrument identifier.

    - `order_id: string`

      Identifier of the order this execution belongs to.

    - `price: string`

      Fill price.

    - `quantity: string`

      Filled quantity.

    - `side: "BUY" or "SELL" or "SELL_SHORT" or "OTHER"`

      Side of the fill.

      - `"BUY"`

      - `"SELL"`

      - `"SELL_SHORT"`

      - `"OTHER"`

    - `symbol: string`

      Trading symbol.

    - `transaction_time: string`

      Transaction timestamp in nanosecond precision (UTC).

### Example

```cli
clst v1:orders get-executions \
  --api-key 'My API Key' \
  --account-id 0
```

#### Response

```json
{
  "metadata": {
    "request_id": "request_id",
    "next_page_token": "U3RhaW5sZXNzIHJvY2tz",
    "page_number": 0,
    "previous_page_token": "U3RhaW5sZXNzIHJvY2tz",
    "total_items": 0,
    "total_pages": 0
  },
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero",
    "details": [
      {
        "foo": "bar"
      }
    ]
  },
  "data": [
    {
      "id": "019d216d-9857-7e23-ae01-edc07126c9e4",
      "instrument_id": "528ec5c3-cdbf-447c-b995-ec6c83cfbc02",
      "order_id": "01928b4d-c000-7000-8000-000000000001",
      "price": "150.25",
      "quantity": "100",
      "side": "BUY",
      "symbol": "AAPL",
      "transaction_time": "2026-03-24T19:58:43.798000Z"
    }
  ]
}
```