---
title: "Retrieve active rates for a merchant"
method: GET
path: "/api/v1/admin/merchants/{merchantId}/rates/active"
tags: ["Merchant Rates", "Admin"]
---

# Retrieve active rates for a merchant

`GET /api/v1/admin/merchants/{merchantId}/rates/active`

## Request

- Base URL: `https://core.quidkey.com`
- URL: `https://core.quidkey.com/api/v1/admin/merchants/{merchantId}/rates/active`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/admin/merchants/:merchantId/rates/active/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve active rates for a merchant

## Path parameters

- `merchantId` string, uuid, required: The unique identifier of the merchant

## Response `200`

Success

- MerchantRatesResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object, required: Merchant rates information
    - `id` string, uuid, required: The unique identifier of the merchant rates
    - `version` string, required: Version identifier for the rates
    - `is_active` boolean, required: Whether these rates are currently active
    - `merchantId` string, uuid, required: The unique identifier of the merchant
    - `created_by` string, required: Identifier of the user/system that created these rates
    - `created_at` string, date-time, required: The creation timestamp
    - `updated_at` string, date-time, required: The last update timestamp
    - `rates` object[], required
      - `id` string, uuid, required: The unique identifier of the rate
      - `defaultRatesId` string, uuid, nullable, required: The ID of the default rates this rate belongs to
      - `merchantRatesId` string, uuid, nullable, required: The ID of the merchant rates this rate belongs to
      - `type` 'domestic_percent_fee' | 'fixed_transaction_fee' | 'conversion_percent_fee' | 'refund_domestic_percent_fee' | 'refund_fixed_transaction_fee' | 'refund_conversion_percent_fee', required: The type of rate
      - `value` number, required: The numeric value of the rate
      - `unit` '%' | 'currency', required: The unit of the rate (% for percentage, currency for fixed amounts)
      - `base` 'gross_amount' | 'gbp' | 'eur' | 'usd', required: The base on which the rate is applied
      - `conversion_currencies` object: Currency pair for conversion rate (both required when specified)
        - `source` string, required: Source currency for conversion
        - `destination` string, required: Destination currency for conversion
      - `notes` string: Optional notes about the rate

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

## Changes

- **2026-06-17** `b372e7d5563d`: 1 breaking, 5 warning, 3 info
  - the `error/code` response's property type changed from `string` to no type for status `400`
  - removed the optional property `error/errors` from the response with the `400` status
  - added the new `conversion_percent_fee` enum value to the `data/rates/items/type` response property for the response status `200`
  - added the new `refund_conversion_percent_fee` enum value to the `data/rates/items/type` response property for the response status `200`
  - …5 more
- **2025-11-05** `6637b341d86d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/admin/merchants/:merchantId/rates/active/get.md)

---

[API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [All operations](https://skmtc.dev/banqzinc/apis/quidkey-api/llms.txt) - [OpenAPI document](https://skmtc.dev/banqzinc/apis/quidkey-api/revisions/f86d2bdbcb08?raw)