---
title: "Get new exchange rate based on already existing rate."
method: GET
path: "/v2/exchange-rates/{id}/refresh"
tags: ["Exchange"]
---

# Get new exchange rate based on already existing rate.

`GET /v2/exchange-rates/{id}/refresh`

## Request

- Base URL: `https://api.sandbox.payall.com`
- URL: `https://api.sandbox.payall.com/v2/exchange-rates/{id}/refresh`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v2/oauth/token`

## Path parameters

- `id` string, uuid, required

## Response `201`

Created

Returns new exchange rate.

- ExchangeRateInstance: `source_amount` represents a value in the currency **from** which the exchange is made. `target_amount` represents a value in the currency **to** which the exchange is made. For example 10 EUR (`source_amount`) converted **to** GBP will result in 8 GBP (`target_amount`).
  - `id` string, uuid
  - `source_amount` Amount
    - `currency` string, iso-4217, required
    - `value` integer, required: Amounts are always in the smallest currency unit. Example: 1000.23 EUR is represented as 100023 euro cents.
  - `target_amount` Amount
    - `currency` string, iso-4217, required
    - `value` integer, required: Amounts are always in the smallest currency unit. Example: 1000.23 EUR is represented as 100023 euro cents.
  - `expiration_date` string, date-time: Exchange rate is valid until this date and time.

## Other responses

- `404`: Not found This response will be sent if exchange rate with provided ID does not exist.
- `405`: Not allowed This response will be sent if existing rate is not expired.
- `409`: Conflict This response will be sent if the exchange rate between currency pairs is no longer available.
- `429`: Too many requests There is a limit of 10 requests per minute for this endpoint.

---

[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)