---
title: "List APR Tiers"
method: GET
path: "/v1/cash_interest/apr_tiers"
tags: ["Cash Interest"]
---

# List APR Tiers

`GET /v1/cash_interest/apr_tiers`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/cash_interest/apr_tiers`
- Auth: HTTP basic

List all available APR tiers. These tiers may be assigned to an account, and will be used to determine the interest rate paid on uninvested cash balances.

## Response `200`

Successful response, returns a list of APR tiers or none if no tiers are available.

- ListAPRTiersResponse: Response to a successful request for a list of APR tiers.
  - `apr_tiers` APRTier[]: All configured APR tiers available for assignment to accounts
    - `account_rate_bps` integer: The annualized account interest rate, in basis points.
    - `correspondent_rate_bps` integer: The annualized correspondent fee rate, in basis points.
    - `created_at` string, date-time: The timestamp the APR tier was created, in RFC 3339 format.
    - `currency` string: The currency of the APR tier
    - `details` APRTierDetails: Additional details of the APR tier
      - `as_of` string, date: The date on which the total balance was recorded, at the end of the day. YYYY-MM-DD format.
      - `total_accounts` integer: The total number of accounts assigned this APR tier.
      - `total_balance` string, decimal: The total balance of funds in this APR tier.
    - `id` string, uuid: The unique identifier of the APR tier
    - `is_default` boolean: Whether this is the default APR tier for its currency. Each currency has at most one default tier. When true, an account that signs the required Alpaca Customer Agreement revision without providing cash_interest may be automatically enrolled in this tier. Do not rely on a default tier for enrollment; always set apr_tier_name explicitly via Create Account or Update Account.
    - `name` string: The unique name of the APR tier
    - `updated_at` string, date-time: The timestamp of the last update to the APR tier, in RFC 3339 format.

## Other responses

- `401`: Unauthorized. Please check your API key and try again.
- `429`: Too many requests. Please wait a moment and try again.
- `500`: A server error occurred. Please contact Alpaca.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)