---
title: "Exchange rates"
method: POST
path: "/exchange-rates/conversion"
tags: ["Services"]
---

# Exchange rates

`POST /exchange-rates/conversion`

This API method allows you to retrieve the exchange rates for different currencies based on a specific amount and your own currency. By providing the amount and the currency code, you can access the current exchange rates against various other currencies. The response will include the exchange rates for the specified amount in comparison to each currency, allowing you to see currency conversions.

## Request body

- object
  - `amount` number, float — Amount of money to get sum in exchange rate for specified currency. Must include 2 decimal places.
  - `countryCode` string — Sender`s country code, according to the ISO 3166-1 Alpha-2 standard.
  - `currencyCode` string — Currency code to get exchange rate, according to the iso-4217 standard.
  - `date` string, date-time — Operation date for exchange rate in ISO 8601 format.

## Response `200`

shipments

- object
  - `requestCurrency` object — Initial amount of money and currency for exchange.
    - `currencyCode` string — Currency code being exchanged, compliant with the ISO-4217 standard.
    - `amount` number, float — Amount of money being exchanged. Must include 2 decimal places.
  - `mainCurrency` object — Calculation of the exchange amount in the currency of the country which countryCode was specified.
    - `currencyCode` string — Currency of the country which countryCode was specified, according to the iso-4217 standard.
    - `amount` number, float — Amount of money in exchange rate of currency for specified country. Must include 2 decimal places.
  - `convertedCurrencies` object[] — List of the calculations for available current exchange rates against various other currencies based on a specified amount of money in request.
    - `currencyCode` string — Currency code, according to the iso-4217 standard.
    - `amount` number, float — Amount of money counted in currency`s exchange rate. Must include 2 decimal places.

## Other responses

- `401` — Unauthorized
- `404` — The specified resource was not found
- `422` — Validation error
- `503` — Connection time-out

---

[API](https://skmtc.net/novapost/apis/api-nova-post.md) · [All operations](https://skmtc.net/novapost/apis/api-nova-post/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novapost/api-nova-post/revisions/60e380005037/schema)