Get Executions

OrderGetExecutionsResponse v1().orders().getExecutions(, )

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.

ParametersExpand Collapse

OrderGetExecutionsParams params

Optional<Long> accountId

Optional<LocalDateTime> from

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

formatdate-time

Optional<List<String>> instrumentIds

Comma-separated instrument identifiers (UUIDs) or symbols (e.g. AAPL) to filter by. When provided, only executions for any of the listed instruments are returned.

Optional<Long> pageSize

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

formatint64

maximum1000

minimum1

Optional<String> pageToken

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

formatbyte

Optional<LocalDateTime> to

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

formatdate-time

ReturnsExpand Collapse

class OrderGetExecutionsResponse:

List<Execution> data

String id

Unique identifier for this execution report.

formatuuid

String orderId

Identifier of the order this execution belongs to.

formatuuid

String quantity

Filled quantity.

Side side

Side of the fill.

One of the following:

BUY("BUY")

SELL("SELL")

SELL_SHORT("SELL_SHORT")

OTHER("OTHER")

LocalDateTime transactionTime

Transaction timestamp in nanosecond precision (UTC).

formatdate-time

Optional<String> instrumentId

Unique instrument identifier. null when this fill has no single resolvable instrument. When a null/undefined value is observed, it indicates it does not apply.

formatuuid

Optional<String> price

Fill price. null for multileg fills, whose price lives only at the leg level. When a null/undefined value is observed, it indicates it does not apply.

Optional<String> symbol

Trading symbol. null when this fill has no single resolvable instrument. When a null/undefined value is observed, it indicates it does not apply.

Get Executions

package com.clearstreet.api.example;

import com.clearstreet.api.client.ClearStreetClient;
import com.clearstreet.api.client.okhttp.ClearStreetOkHttpClient;
import com.clearstreet.api.models.v1.orders.OrderGetExecutionsParams;
import com.clearstreet.api.models.v1.orders.OrderGetExecutionsResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        OrderGetExecutionsResponse response = client.v1().orders().getExecutions(0L);
    }
}

{
  "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",
      "order_id": "01928b4d-c000-7000-8000-000000000001",
      "quantity": "100",
      "side": "BUY",
      "transaction_time": "2026-03-24T19:58:43.798000Z",
      "instrument_id": "528ec5c3-cdbf-447c-b995-ec6c83cfbc02",
      "price": "150.25",
      "symbol": "AAPL"
    }
  ]
}

Returns Examples

{
  "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",
      "order_id": "01928b4d-c000-7000-8000-000000000001",
      "quantity": "100",
      "side": "BUY",
      "transaction_time": "2026-03-24T19:58:43.798000Z",
      "instrument_id": "528ec5c3-cdbf-447c-b995-ec6c83cfbc02",
      "price": "150.25",
      "symbol": "AAPL"
    }
  ]
}