CLclear-street
Orders

Get Executions

Changed on

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

get/v1/accounts/{account_id}/executions

Request

  • Base URL
    https://api.clearstreet.com
  • Auth
    HTTP bearer

Path parameters

account_idinteger required

Account identifier

Query parameters

instrument_idsstring[]

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.

order_idsstring[]

Comma-separated order IDs to filter by. When provided, only executions belonging to an order in this set are returned.

underlying_instrument_idsstring[]

Comma-separated instrument IDs (UUID) or symbols (equity tickers or OSI option symbols). Matches option fills whose resolved underlier is any of the given instruments.

page_sizeinteger

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

page_tokenstring byte

Base64URL-encoded pagination token

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

fromstring date-time

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

tostring date-time

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

Response

List of executions

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "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",
      "venue": "XNAS"
    }
  ]
}

Changes

  • 1bd9eddeffc8Revision changes
    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became optional for the status

    • warning

      for the query request parameter instrument_ids, the type of property items/ changed from no type to string

    • info

      added the new optional query request parameter order_ids

    • info

      added the new optional query request parameter underlying_instrument_ids

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed the OTHER enum value from the /// response property for the response status

    • info

      removed the SELL_SHORT enum value from the /// response property for the response status

  • 4b5aaa49308cRevision changes
    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became optional for the status

    • breaking

      the response property /// became optional for the status