---
title: "Changes to Retrieve account earnings (P&L)"
method: GET
path: "/accounts/{account_id}/earnings"
---

# Changes to Retrieve account earnings (P&L)

`GET /accounts/{account_id}/earnings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 24 revisions.

- **2026-10-29** `6a63920239d8`: 5 breaking, 3 warning, 24 info
- **2026-10-27** `b4b87fc2006c`: 9 info
- **2026-10-06** `aa43bab6253c`: 1 breaking
- **2026-09-29** `ec2ca1037fde`: 1 info
- **2026-09-29** `8371b27e56c7`: 13 breaking, 4 info
- **2026-08-13** `5b4c43e2941b`: 4 info
- **2026-07-17** `8e8a8242f1f2`: 2 breaking, 8 info
- **2026-07-13** `03da9bc8e86b`: 2 info

## Changes

- **2026-10-29** `6a63920239d8`: 5 breaking, 3 warning, 24 info
  - the `cash` response's property type changed from no type to `object` for status `200`
  - the `currency` response's property type changed from no type to `string` for status `200`
  - the `position_earnings/items/reporting` response's property type changed from no type to `object` for status `200`
  - the `position_earnings/items/trading` response's property type changed from no type to `object` for status `200`
  - the `positions` response's property type changed from no type to `object` for status `200`
  - added the new `EUR` enum value to the `currency` response property for the response status `200`
  - added the new `GBP` enum value to the `currency` response property for the response status `200`
  - added the new `USD` enum value to the `currency` response property for the response status `200`
  - removed `#/components/schemas/AccountCashEarnings` from the `cash` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AccountPositionsEarnings` from the `positions` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/Currency` from the `currency` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/PositionReportingEarnings` from the `position_earnings/items/reporting` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/PositionTradingEarnings` from the `position_earnings/items/trading` response property `allOf` list for the response status `200`
  - added the required property `cash/attribution` to the response with the `200` status
  - added the required property `cash/gross` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/attribution` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/cost_basis` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/currency` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/gross` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/money_in` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/simple_return` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/simple_return_annualised` to the response with the `200` status
  - added the required property `position_earnings/items/trading/attribution` to the response with the `200` status
  - added the required property `position_earnings/items/trading/cost_basis` to the response with the `200` status
  - added the required property `position_earnings/items/trading/currency` to the response with the `200` status
  - added the required property `position_earnings/items/trading/gross` to the response with the `200` status
  - added the required property `position_earnings/items/trading/money_in` to the response with the `200` status
  - added the required property `position_earnings/items/trading/simple_return` to the response with the `200` status
  - added the required property `position_earnings/items/trading/simple_return_annualised` to the response with the `200` status
  - added the required property `position_earnings/items/trading/unrealized_percentage` to the response with the `200` status
  - added the required property `positions/attribution` to the response with the `200` status
  - added the required property `positions/gross` to the response with the `200` status
- **2026-10-27** `b4b87fc2006c`: 9 info
  - added the required property `money_in` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/allOf[subschema #1: PositionReportingEarnings]/money_in` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/allOf[subschema #1: PositionReportingEarnings]/simple_return` to the response with the `200` status
  - added the required property `position_earnings/items/reporting/allOf[subschema #1: PositionReportingEarnings]/simple_return_annualised` to the response with the `200` status
  - added the required property `position_earnings/items/trading/allOf[subschema #1: PositionTradingEarnings]/money_in` to the response with the `200` status
  - added the required property `position_earnings/items/trading/allOf[subschema #1: PositionTradingEarnings]/simple_return` to the response with the `200` status
  - added the required property `position_earnings/items/trading/allOf[subschema #1: PositionTradingEarnings]/simple_return_annualised` to the response with the `200` status
  - added the required property `simple_return` to the response with the `200` status
  - added the required property `simple_return_annualised` to the response with the `200` status
- **2026-10-06** `aa43bab6253c`: 1 breaking
  - response property `context/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `400`
- **2026-09-29** `ec2ca1037fde`: 1 info
  - added the optional property `position_earnings` to the response with the `200` status
- **2026-09-29** `8371b27e56c7`: 13 breaking, 4 info
  - removed the required property `gross_capital` from the response with the `200` status
  - removed the required property `gross_income` from the response with the `200` status
  - removed the required property `gross_realized` from the response with the `200` status
  - removed the required property `gross_total` from the response with the `200` status
  - removed the required property `gross_unrealized` from the response with the `200` status
  - removed the required property `net_realized` from the response with the `200` status
  - removed the required property `net_total` from the response with the `200` status
  - removed the required property `net_unrealized` from the response with the `200` status
  - removed the required property `position_earnings` from the response with the `200` status
  - removed the required property `realized_capital` from the response with the `200` status
  - removed the required property `realized_income` from the response with the `200` status
  - removed the required property `unrealized_capital` from the response with the `200` status
  - removed the required property `unrealized_income` from the response with the `200` status
  - added the required property `cash` to the response with the `200` status
  - added the required property `gross` to the response with the `200` status
  - added the required property `net` to the response with the `200` status
  - added the required property `positions` to the response with the `200` status
- **2026-08-13** `5b4c43e2941b`: 4 info
  - added the required property `gross_capital` to the response with the `200` status
  - added the required property `gross_income` to the response with the `200` status
  - added the required property `position_earnings/items/gross_capital` to the response with the `200` status
  - added the required property `position_earnings/items/gross_income` to the response with the `200` status
- **2026-07-17** `8e8a8242f1f2`: 2 breaking, 8 info
  - the `currency` response's property type changed from `string` to no type for status `200`
  - the `position_earnings/items/currency` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/Currency` to the `currency` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Currency` to the `position_earnings/items/currency` response property `allOf` list for the response status `200`
  - removed the `EUR` enum value from the `currency` response property for the response status `200`
  - removed the `EUR` enum value from the `position_earnings/items/currency` response property for the response status `200`
  - removed the `GBP` enum value from the `currency` response property for the response status `200`
  - removed the `GBP` enum value from the `position_earnings/items/currency` response property for the response status `200`
  - removed the `USD` enum value from the `currency` response property for the response status `200`
  - removed the `USD` enum value from the `position_earnings/items/currency` response property for the response status `200`
- **2026-07-13** `03da9bc8e86b`: 2 info
  - api tag `performance` added
  - api tag `Performance` removed

---

[Operation](https://skmtc.dev/joinsophic/apis/sophic-engine-api/docs/accounts/:account_id/earnings/get.md) - [API](https://skmtc.dev/joinsophic/apis/sophic-engine-api.md) - [Page](https://skmtc.dev/joinsophic/apis/sophic-engine-api/changes/accounts/:account_id/earnings/get)
