---
title: "List account rate of returns"
method: GET
path: "/accounts/{accountId}/returnRates"
tags: ["Account Information"]
---

# List account rate of returns

`GET /accounts/{accountId}/returnRates`

Returns a list of rate of return percents for a given account.

## Path parameters

- `accountId` string, uuid, required — Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.

## Query parameters

- `userId` string, required — SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.
- `userSecret` string, required — SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the [rotate user secret endpoint](/reference/Authentication/Authentication_resetSnapTradeUserSecret).
- `timeframes` string

## Response `200`

OK

- RateOfReturnResponse — List of return rates with their timeframe
  - `data` RateOfReturnObject[] — List of return percentages
    - `timeframe` 'ALL' | '1Y' | 'YTD' | '1M' | '1W' | '1D' — The timeframe this return percent is reflecting
    - `return_percent` number — The percent return of the portfolio, directly from the brokerage. 5.97 indicates a 5.97% return over the timeframe
    - `created_date` string, date-time — The date this was fetched

## Other responses

- `403` — Forbidden
- `500` — Unexpected error
- `501` — Not Implemented - return rates are not supported for this brokerage
- `503` — Brokerage API failure

## Changes

- **2026-07-21** `6a1d86d094d7` — 1 info
  - added the non-success response with the status `501`
- **2026-06-24** `dfb77b0eb8ce` — 1 info
  - added the non-success response with the status `503`
- **2026-04-21** `38856e7dc610` — 3 warning, 3 info
  - added the new `1D` enum value to the `data/items/timeframe` response property for the response status `200`
  - added the new `1W` enum value to the `data/items/timeframe` response property for the response status `200`
  - added the new `YTD` enum value to the `data/items/timeframe` response property for the response status `200`
  - added the new optional `query` request parameter `timeframes`
  - …2 more
- **2026-03-06** `6a3b37154f49` — 3 warning, 4 info
  - deleted the `query` request parameter `timeframes`
  - added the new `3M` enum value to the `data/items/timeframe` response property for the response status `200`
  - added the new `6M` enum value to the `data/items/timeframe` response property for the response status `200`
  - removed the non-success response with the status `503`
  - …3 more

[Change history](https://skmtc.dev/passiv/apis/snaptrade/changes/accounts/:accountId/returnRates/get.md)

---

[API](https://skmtc.dev/passiv/apis/snaptrade.md) · [All operations](https://skmtc.dev/passiv/apis/snaptrade/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/passiv/snaptrade/revisions/3c65c49d0b5d/schema)