Services

Exchange rates

post

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/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.

🔹Description of control elements:

SCHEMA

Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.

• Single line description A description that fits into a single line; any text that does not fit remains hidden.

• Multiline description An expanded description that displays more than one line of text.

EXAMPLE

Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.

Authorizations

JWT

AuthorizationstringRequired

Authorization JWT-token with a lifetime of 1 hour in header

Body

application/json

amountnumber · floatOptional

Amount of money to get sum in exchange rate for specified currency. Must include 2 decimal places.

Example: 100

countryCodestringOptional

Sender`s country code, according to the ISO 3166-1 Alpha-2 standard.

Pattern: ^[A-Z]{2}$

currencyCodestringOptional

Currency code to get exchange rate, according to the iso-4217 standard.

Pattern: ^[A-Z]{3}$

datestring · date-timeOptional

Operation date for exchange rate in ISO 8601 format.

Example: 2023-10-16T00:00:00Z

Responses

200

shipments

application/json

401

Unauthorized

application/json

404

The specified resource was not found

application/json

422

Validation error

application/json

503

Connection time-out

application/json

post

/exchange-rates/conversion

HTTPcURLJavaScriptPython

POST /v.1.0/exchange-rates/conversion HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "amount": 100,
  "countryCode": "UA",
  "currencyCode": "USD",
  "date": "2023-10-16T00:00:00.000000Z"
}

{
  "requestCurrency": {
    "currencyCode": "USD",
    "amount": 100
  },
  "mainCurrency": {
    "currencyCode": "UAH",
    "amount": 3662.16
  },
  "convertedCurrencies": [
    {
      "currencyCode": "TND",
      "amount": 317.18
    },
    {
      "currencyCode": "CZK",
      "amount": 2320.03
    },
    {
      "currencyCode": "BRL",
      "amount": 504.08
    },
    {
      "currencyCode": "TRY",
      "amount": 2755.78
    },
    {
      "currencyCode": "RON",
      "amount": 472.25
    },
    {
      "currencyCode": "EUR",
      "amount": 95.02
    },
    {
      "currencyCode": "MDL",
      "amount": 1823.15
    },
    {
      "currencyCode": "ZAR",
      "amount": 1956.6
    },
    {
      "currencyCode": "NZD",
      "amount": 168.27
    },
    {
      "currencyCode": "SAR",
      "amount": 375.59
    },
    {
      "currencyCode": "LYD",
      "amount": 489.62
    },
    {
      "currencyCode": "PLN",
      "amount": 437.49
    },
    {
      "currencyCode": "GBP",
      "amount": 82.31
    }
  ]
}