---
title: "Get carded exchange rates"
method: GET
path: "/v2/carded-rates"
tags: ["Exchange"]
---

# Get carded exchange rates

`GET /v2/carded-rates`

## Request

- Base URL: `https://api.sandbox.payall.com`
- URL: `https://api.sandbox.payall.com/v2/carded-rates`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v2/oauth/token`

## Response `200`

OK

- CardedRates
  - `rates` CardedRate[], required
    - `id` string, uuid, required: Unique identifier of the exchange rate. This identifier can be used to identify the exchange rate when making payments with explicit exchange rate flow.
    - `from_currency` string, required: Currency code as defined by ISO 4217. For example `USD` for US Dollar.
    - `to_currency` string, required: Currency code as defined by ISO 4217. For example `EUR` for Euro.
    - `valid_from` string, date-time, required: The date-time from which the exchange rate is valid. Notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
    - `valid_to` string, date-time, required: The date-time until which the exchange rate is valid. Notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
    - `payment_instrument_category` 'BankAccount' | 'MobileWallet' | 'CashPickup' | 'Card'
    - `rate` number, required: Exchange rate for the currency pair defined by `from_currency` and `to_currency`. For example `0.8783` for USD to EUR. For partners utilizing tiered pricing, this value will represent the exchange rate for the lowest tier.
    - `tiers` CardedRateTier[]
      - `id` string, uuid, required: Unique identifier of the exchange rate. This identifier can be used to identify the exchange rate when making payments with explicit exchange rate flow.
      - `from_amount` integer, required: The amount in the `from_currency` from which the exchange rate is valid. Amounts are always in the smallest currency unit. Example: 1000.23 USD is represented as 100023 cents. For partners utilizing tiered pricing, this value will represent the starting amount for the tier.
      - `rate` number, required: Exchange rate for the currency pair defined by `from_currency` and `to_currency`. For example `0.8783` for USD to EUR.

---

[API](https://skmtc.dev/payall/apis/payall-m2m-authentication-api.md) - [All operations](https://skmtc.dev/payall/apis/payall-m2m-authentication-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payall/apis/payall-m2m-authentication-api/revisions/5f561eccd6ce?raw)