---
title: "Get rates for a specific benchmark"
method: GET
path: "/v1/interest/benchmark-rate/{benchmark}"
tags: ["Benchmark rate"]
---

# Get rates for a specific benchmark

`GET /v1/interest/benchmark-rate/{benchmark}`

Get all rates configured for a specific benchmark.

## Path parameters

- `benchmark` string, required

## Headers

- `content-type` string, required
- `Authorization` string, required

## Response `200`

OK

- GetBenchmarkRateResponse
  - `get_benchmark_rate_list` GetBenchmarkRate[] — Benchmark rate list
    - `benchmark` 'BOE' | 'DI' | 'FED' | 'RBA' | 'RBI' | 'TO' — Market index used to measure interest value over time. - `BOE`: Bank of England, UK - `DI`: Interbank Deposit Contract, Brazil - `FED`: Federal Reserve System, USA - `RBA`: Reserve Bank of Australia - `RBI`: Reserve Bank of India - `TO`: Overnight Interbank Target Rate (Tasa Objetivo), Mexico
    - `benchmark_rate` number, double — Annual market index rate
    - `start_date` string, date — Date to start applying the benchmark rate in the accrual process. Format = YYYY-MM-DD.
    - `version` string — Benchmark rate version. Format = YYYY-MM.
    - `division_id` string — Division ID attached to the interest plan for accrual by division
    - `interest_by_tiers` InterestByTiers — Interest by tiers configuration
      - `type` 'TERM' | 'AMOUNT', required — Interest type - `TERM`: Interest rate varies according to the period of time since the deposit was made. - `AMOUNT`: Interest rate varies according to the current balance.
      - `tier_calculation` 'RETROACTIVE' | 'NON-RETROACTIVE', required — Tier calculation method - `RETROACTIVE`: Interest is recalculated from the beginning based on the new applicable rate. - `NON-RETROACTIVE`: Interest is calculated progressively based on each layer rate.
      - `tiers` InterestByTiersArrayObject[], required
        - `days` integer — Number of days in `interest_by_tier`
        - `amount` number, double — Fee amount.
        - `margin_rate` number, double — Rate linked to the benchmark rate. For example, for 110% FED, margin rate is 110%. If a `benchmark` value is not provided, this field must be null.
        - `fixed_interest_rate` number, float — Fixed annual interest rate for investments or deposits. If a `benchmark` value is provided, this field must be null.
    - `interest_thresholds` InterestThresholds — Cap and floor thresholds for the interest plan
      - `cap_threshold` number, double — Cap threshold value. If you provide a value for `cap_threshold`, you must also provide a value for `cap_effective_rate`.
      - `cap_effective_rate` number, double — Cap effective rate. If you provide a value for `cap_effective_rate`, you must also provide a value for `cap_threshold`.
      - `floor_threshold` number, double — Floor threshold value
      - `floor_effective_rate` number, double — Floor effective rate

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)