CBU exchange rate (single currency)

Returns the official exchange rate of the Central Bank of the Republic of Uzbekistan for a single currency. 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

ProductionStage

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

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

Request

Query parameters

Parameter	Type	Required	Description
`ccy`	string	Yes	Numeric ISO 4217 currency code, e.g. `"840"` (USD). See «Currency codes».

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/rate?ccy=840' \
  --header 'X-Api-Key: 00000000-0000-4000-8000-000000000000'

Response

2004044225XX

Example 200 (OK) response

{
  "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
`code`	string	Numeric ISO 4217 currency code.
`ccy`	string	Letter ISO 4217 currency code, e.g. `"USD"`.
`name_ru`	string	Currency name in Russian.
`name_en`	string	Currency name in English.
`nominal`	integer	The number of currency units `rate` is quoted for.
`rate`	number	Rate in UZS per `nominal` units of the currency.
`diff`	number	Rate change compared to the previous day.
`date`	string	Date of the rate in `dd.mm.yyyy` format.
`date_iso`	string	Date of the rate in `yyyy-mm-dd` format.

What this response means

The CBU exchange rate is updated once a day.

What to do next

Use rate to display the official exchange rate.

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	`20044` — integration not connected; `20099` — the rate for this currency is unavailable from the CBU.
`errors[].message`	string	Description of the cause.

What this response means

For code 20044, contact KVELL support to connect the integration with the rates provider. For code 20099, check the currency code in ccy.

What to do next

Fix the cause of the error and retry the request.

Example 422 (Unprocessable Entity) response

{
  "errors": [
    {
      "code": 20098,
      "message": "ccy: Field required"
    }
  ]
}

Response parameters

Parameter	Type	Description
`errors`	array	List of validation errors.
`errors[].code`	integer	Error code.
`errors[].message`	string	The field and the reason for the validation error.

What this response means

The required ccy parameter was not passed, or it does not match the expected format.

What to do next

Fix the field from errors[].message and retry the request.

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.