Курсы ЦБ РУз (список)

Возвращает все официальные курсы Центрального банка Республики Узбекистан на текущий день (порядка 75 валют). В отличие от «Курс валюты», это референсный курс без спреда — используйте для отображения официального курса и бухгалтерии, не для фактической конвертации сумм.

URL

ProductionStage

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

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

Запрос

Метод не принимает параметров запроса.

Заголовки

Название	Тип	Обязательно	Описание
`X-Api-Key`	string	Да	Идентификатор магазина.

Подпись X-Signature для этого метода не требуется.

Пример

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

Ответ

2004045XX

Пример ответа 200 (OK)

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

Параметры ответа

Параметр	Тип	Описание
`date`	string	Дата курсов в формате `дд.мм.гггг`.
`rates`	array	Список курсов по всем валютам ЦБ РУз.
`rates[].code`	string	Числовой код валюты ISO 4217.
`rates[].ccy`	string	Буквенный код валюты ISO 4217, например `"USD"`.
`rates[].name_ru`	string	Название валюты на русском.
`rates[].name_en`	string	Название валюты на английском.
`rates[].nominal`	integer	За сколько единиц валюты указан `rate`.
`rates[].rate`	number	Курс в UZS за `nominal` единиц валюты.
`rates[].diff`	number	Изменение курса к предыдущему дню.
`rates[].date`	string	Дата курса в формате `дд.мм.гггг`.
`rates[].date_iso`	string	Дата курса в формате `гггг-мм-дд`.

Что означает ответ

Курсы ЦБ РУз обновляются раз в сутки — date одинаков для всех валют в ответе.

Что делать дальше

Найдите нужную валюту в rates по полю code или ccy.

Пример ответа 404 (Not Found)

{
  "errors": [
    {
      "code": 20044,
      "message": "Интеграция с Montra не настроена для магазина"
    }
  ]
}

Параметры ответа

Параметр	Тип	Описание
`errors`	array	Список ошибок. Коды и рекомендации по обработке приведены в разделе «Ошибки HTTP-ответов».
`errors[].code`	integer	Код ошибки.
`errors[].message`	string	Описание причины.

Что означает ответ

Интеграция с провайдером курсов не подключена для магазина.

Что делать дальше

Обратитесь в поддержку KVELL, чтобы подключить интеграцию с провайдером курсов.

Пример ответа 5XX (Internal Server Error)

{
  "errors": [
    {
      "code": 20000,
      "message": "Неизвестная ошибка"
    }
  ]
}

Параметры ответа

Параметр	Тип	Описание
`errors`	array	Список ошибок. Коды и рекомендации по обработке приведены в разделе «Ошибки HTTP-ответов».
`errors[].code`	integer	Код ошибки.
`errors[].message`	string	Описание технической ошибки.

Что означает ответ

Метод read-only и ничего не меняет — техническая ошибка не может привести к неопределённому результату.

Что делать дальше

Безопасно повторите тот же запрос. Если ошибка повторяется, обратитесь в поддержку KVELL и передайте URL, время запроса, HTTP-код, code и message.