---
title: "GET /getRates"
method: GET
path: "/getRates"
tags: ["GET"]
---

# GET /getRates

`GET /getRates`

Fetches the list of current foreign exchange rate offers that are available to the supplier.<br><br> The returned foreign exchange rates are only guaranteed up to the expiry time specified— typically 24 hours. Attempting to create an order using an expired foreign exchange rate will result in an error. To avoid confusion it is recommended to call getRates several times per day.

## Query parameters

- `MerchantId` string, uuid, required — The 36 character GUID which identifies the supplier to the Reach system.
- `Callback` string — JSONP Javascript function name.

## Response `200`

Rates information was successfully retrieved.

- object
  - `RateOffers` object[] — An array of rate offers, if guaranteed rates are available.
    - `Id` string, uuid, required — A Reach rate offer ID for the supplier that can be used until the specified Expiry.
    - `Currency` string, required — The upper-case 3 character ISO 4217 currency code for this rate offer.
    - `Expiry` string, date-time, required — The RFC 3339 timestamp at which this rate offer expires.
    - `Rate` number, double, required — The Reach guaranteed exchange rate.
  - `Rates` object[] — An array of non-guaranteed market rates that are returned if spot rates are enabled and guaranteed rates are not enabled.
    - `Currency` string, required — The upper-case 3 character ISO 4217 currency code for this rate offer.
    - `Rate` number, double, required — The approximate market exchange rate, updated regularly.

## Other responses

- `400` — If present, the getRates request structure was invalid and unable to be parsed.
- `404` — If present, a value of the request was unable to be found. For example, if the MerchantId provided could not be found in the given environment
- `503` — There was a system problem and the request should be tried again.

---

[API](https://skmtc.net/withreach/apis/reach-checkout-api.md) · [All operations](https://skmtc.net/withreach/apis/reach-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withreach/reach-checkout-api/versions/f95f4b8dd180/schema)