Перейти к содержимому

История курсов валют

GET
/v2/company-currency-rates
curl --request GET \
--url 'https://api-admin.billz.ai/v2/company-currency-rates?page=1&limit=5&start_date=2020-01-01&end_date=2024-07-26' \
--header 'Authorization: Bearer <token>' \
--header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'

Коды ошибок: 400 — ошибка валидации входных данных; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.

page
integer format: int32
default: 1

Не число -> 400 ‘error while parsing page’

Example
1
limit
integer format: int32
default: 10

Не число -> 400 (сообщение то же — ‘error while parsing page’)

Example
5
currency
string

Код валюты (USD, UZS, EUR). Пустая строка = без фильтра

start_date
string

Дата начала действия курса, формат YYYY-MM-DD

Example
2020-01-01
end_date
string

Дата окончания, формат YYYY-MM-DD

Example
2024-07-26
platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Идентификатор платформы. Для интеграций используется статичное значение.

Успешный ответ

Media typeapplication/json
object
rates

Если курсов нет — 200 с пустым или null значением

Array<object>
nullable
object
id
string
source_currency

USD, UZS, EUR

string
target_currency

Может быть пустой строкой у исторических записей

string
rate
number format: double
valid_from

Формат ‘YYYY-MM-DD HH:MM:SS’

string
valid_to

Пустая строка = курс действует до сих пор

string
count

Общее количество записей

integer format: int32
Examplegenerated
{
"rates": [
{
"id": "example",
"source_currency": "example",
"target_currency": "example",
"rate": 1,
"valid_from": "example",
"valid_to": "example"
}
],
"count": 1
}