Skip to content

CBU exchange rates (list)

Returns all official exchange rates of the Central Bank of the Republic of Uzbekistan for the current day (around 75 currencies). Unlike «Exchange rate», this is a reference rate without a spread — use it for displaying the official rate and for accounting, not for actually converting amounts.

URL

GET https://api.pay.kvell.group/v1/currency/cbu/rates

GET https://api.pay.stage.kvell.group/v1/currency/cbu/rates

Request

The method does not accept request parameters.

Headers

Name Type Required Description
X-Api-Key string Yes Shop identifier.

The X-Signature signature is not required for this method.

Example

curl --request GET \
  --url 'https://api.pay.stage.kvell.group/v1/currency/cbu/rates' \
  --header 'X-Api-Key: 00000000-0000-4000-8000-000000000000'

Response

Example 200 (OK) response
{
  "date": "15.07.2026",
  "rates": [
    {
      "code": "840",
      "ccy": "USD",
      "name_ru": "Доллар США",
      "name_en": "US Dollar",
      "nominal": 1,
      "rate": 12065.49,
      "diff": -27.38,
      "date": "15.07.2026",
      "date_iso": "2026-07-15"
    }
  ]
}

Response parameters

Parameter Type Description
date string Date of the rates in dd.mm.yyyy format.
rates array List of rates for all CBU currencies.
rates[].code string Numeric ISO 4217 currency code.
rates[].ccy string Letter ISO 4217 currency code, e.g. "USD".
rates[].name_ru string Currency name in Russian.
rates[].name_en string Currency name in English.
rates[].nominal integer The number of currency units rate is quoted for.
rates[].diff number Rate change compared to the previous day.
rates[].rate number Rate in UZS per nominal units of the currency.
rates[].date string Date of the rate in dd.mm.yyyy format.
rates[].date_iso string Date of the rate in yyyy-mm-dd format.

What this response means

CBU exchange rates are updated once a day — date is the same for all currencies in the response.

What to do next

Find the currency you need in rates by the code or ccy field.

Example 404 (Not Found) response
{
  "errors": [
    {
      "code": 20044,
      "message": "The integration with Montra is not configured for the shop"
    }
  ]
}

Response parameters

Parameter Type Description
errors array List of errors. Codes and handling recommendations are given in «HTTP response errors».
errors[].code integer Error code.
errors[].message string Description of the cause.

What this response means

The integration with the rates provider is not connected for the shop.

What to do next

Contact KVELL support to connect the integration with the rates provider.

Example 5XX (Internal Server Error) response
{
  "errors": [
    {
      "code": 20000,
      "message": "Unknown error"
    }
  ]
}

Response parameters

Parameter Type Description
errors array List of errors. Codes and handling recommendations are given in «HTTP response errors».
errors[].code integer Error code.
errors[].message string Description of the technical error.

What this response means

The method is read-only and changes nothing — a technical error cannot lead to an indeterminate result.

What to do next

Safely retry the same request. If the error persists, contact KVELL support and provide the URL, request time, HTTP code, code, and message.