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.

Authorizations

AuthorizationstringRequired

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

Body

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

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
    }
  ]
}