---
title: "List PNL Sums"
method: GET
path: "/accounts/{account_id}/pnl-sums"
tags: ["Performance"]
---

# List PNL Sums

`GET /accounts/{account_id}/pnl-sums`

## Request

- Base URL: `https://api.clearstreet.io/studio/v2`
- URL: `https://api.clearstreet.io/studio/v2/accounts/{account_id}/pnl-sums`
- Auth: HTTP bearer

List historical PNL summations for a given account over a given date range, filtered on the given query parameters.

## Path parameters

- `account_id` string, required: Account ID for the account.

## Query parameters

- `starting_date` integer, required: Integer in YYYYMMDD representing a date.
- `ending_date` integer, required: Integer in YYYYMMDD representing a date.

## Response `200`

Successful response

- object
  - `starting_date` integer: Integer in YYYYMMDD representing a date.
  - `ending_date` integer: Integer in YYYYMMDD representing a date.
  - `entity_id` string: Entity ID for the legal entity.
  - `account_id` string: Account ID for the account.
  - `account_number` string: Account number for the account.
  - `starting_equity` number, double: The equity at the start of the date range. Start of day equity of the starting date in the date range.
  - `ending_equity` number, double: The equity at the end of the date range. End of day equity of the ending date in the date range.
  - `day_pnl` number, double: Sum of profit and loss from intraday trading activities for the given date range across all symbols.
  - `position_pnl` number, double: Sum of profit and loss from previous trading date across all symbols.
  - `unrealized_pnl` number, double: Sum of profit and loss from market changes across all symbols.
  - `realized_pnl` number, double: Sum of profit and loss realized from position closing trading activity across all symbols.
  - `total_pnl` number, double: `realized_pnl + unrealized_pnl`
  - `net_pnl` number, double: `P&L after netting all realized and unrealized P&L, adjustments, dividends, change in accruals, income and expenses`
  - `data` PnlSum[]
    - `symbol` string
    - `asset_class` 'other' | 'currency' | 'equity' | 'option' | 'debt' | 'fund': The asset class of the symbol.
    - `day_pnl` number, double: Sum of profit and loss from intraday trading activities for the given date range
    - `position_pnl` number, double: Sum of profit and loss from previous trading date.
    - `unrealized_pnl` number, double: Sum of profit and loss from market changes.
    - `realized_pnl` number, double: Sum of profit and loss realized from position closing trading activity.
    - `total_pnl` number, double: `realized_pnl + unrealized_pnl`
    - `net_pnl` number, double: `P&L after netting all realized and unrealized P&L, adjustments, dividends, change in accruals, income and expenses`
    - `sold_quantity` string: String representation of quantity.
    - `sold_notional` number, double: Sum of the notional sold.
    - `bought_quantity` string: String representation of quantity.
    - `bought_notional` number, double: Sum of the notional bought.

## Other responses

- `default`: Error response

## Changes

- **2025-03-14** `576ab6a21619`: 2 info
  - added the optional property `data/items/net_pnl` to the response with the `200` status
  - added the optional property `net_pnl` to the response with the `200` status
- **2025-02-19** `c7456ea00706`: 4 warning
  - deleted the `query` request parameter `symbol`
  - deleted the `query` request parameter `underlying_symbol`
  - removed the optional property `symbol` from the response with the `200` status
  - removed the optional property `underlying_symbol` from the response with the `200` status
- **2024-12-09** `507601d53317`: 1 info
  - added the optional property `account_number` to the response with the `200` status
- **2024-10-11** `468b5da24bbf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clear-street/apis/common-api-models/changes/accounts/:account_id/pnl-sums/get.md)

---

[API](https://skmtc.dev/clear-street/apis/common-api-models.md) - [All operations](https://skmtc.dev/clear-street/apis/common-api-models/llms.txt) - [OpenAPI document](https://skmtc.dev/clear-street/apis/common-api-models/revisions/585e71254e37?raw)