B2BB2C

Получение курса валют в отделениях Альфа-Банка

Песочница
GET https://sandbox.alfabank.ru/api/rates/gd/v1/offices-rates
Пром
GET https://baas.alfabank.ru/api/rates/gd/v1/offices-rates
Scope

offices-rates

Описание

Метод позволяет получить текущий курс обмена валют в отделениях Альфа-Банка.

Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

QUERY
Атрибут
Описание
limit
integeroptional

Количество объектов на одной странице. Значение по умолчанию: 300

offset
integeroptional

Количество объектов в списке, которые необходимо пропустить. Значение по умолчанию: 0

Пример запроса
Язык
1curl --location --globoff 'https://baas.alfabank.ru/api/rates/gd/v1/offices-rates?limit={limit}&offset={offset}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'
Параметры ответа
Пример ответа 200 (OK)
1{
2  "pagination": {
3    "limit": 2,
4    "offset": 10,
5    "totalCount": 350
6  },
7  "offices-rates": [
8    {
9      "createdAt": "2025-10-23T13:49:47.000Z",
10      "offices": [
11        {
12          "id": "MOCO",
13          "updatedAt": "2025-10-23T12:00:00.000Z",
14          "exchangeRates": [
15            {
16              "destinationCurrency": "USD",
17              "sourceCurrency": "RUR",
18              "buy": 93.3,
19              "sell": 94.79
20            },
21            {
22              "destinationCurrency": "EUR",
23              "sourceCurrency": "RUR",
24              "buy": 101.2,
25              "sell": 103.69
26            },
27            {
28              "destinationCurrency": "CNY",
29              "sourceCurrency": "RUR",
30              "buy": 101.2,
31              "sell": 103.69
32            }
33          ]
34        },
35        {
36          "id": "MOGO",
37          "updatedAt": "2025-10-23T12:00:00.000Z",
38          "exchangeRates": [
39            {
40              "destinationCurrency": "USD",
41              "sourceCurrency": "RUR",
42              "buy": 92.3,
43              "sell": 93.79
44            },
45            {
46              "destinationCurrency": "EUR",
47              "sourceCurrency": "RUR",
48              "buy": 100.2,
49              "sell": 102.69
50            },
51            {
52              "destinationCurrency": "CNY",
53              "sourceCurrency": "RUR",
54              "buy": 30.2,
55              "sell": 31.69
56            }
57          ]
58        }
59      ]
60    }
61  ]
62}
BODY
атрибут
описание
objectoptional

Данные пагинации

limit
integerrequired

Количество объектов на одной странице. Значение по умолчанию: 300

offset
integerrequired

Количество объектов в списке, которые необходимо пропустить. Значение по умолчанию: 0

totalCount
integeroptional

Общее количество объектов

array of objectsoptional

Курсы валют в отделениях банка

createdAt
stringoptional

Дата и время формирования ответа в формате YYYY-MM-DDThh:mm:ss.sssZ

array of objectsoptional

Список отделений банка с курсами валют

id
integeroptional

Уникальный идентификатор отделения банка

updatedAt
stringoptional

Дата и время последнего обновления курсов в формате YYYY-MM-DDThh:mm:ss.sssZ

array of objectsoptional

Список валют с курсами покупки и продажи

destinationCurrency
stringoptional

Базовая валюта

sourceCurrency
stringoptional

Котируемая валюта

buy
numberoptional

Курс покупки валюты банком

sell
numberoptional

Курс продажи валюты банком

Пример ответа 200 (OK)
1{
2  "pagination": {
3    "limit": 2,
4    "offset": 10,
5    "totalCount": 350
6  },
7  "offices-rates": [
8    {
9      "createdAt": "2025-10-23T13:49:47.000Z",
10      "offices": [
11        {
12          "id": "MOCO",
13          "updatedAt": "2025-10-23T12:00:00.000Z",
14          "exchangeRates": [
15            {
16              "destinationCurrency": "USD",
17              "sourceCurrency": "RUR",
18              "buy": 93.3,
19              "sell": 94.79
20            },
21            {
22              "destinationCurrency": "EUR",
23              "sourceCurrency": "RUR",
24              "buy": 101.2,
25              "sell": 103.69
26            },
27            {
28              "destinationCurrency": "CNY",
29              "sourceCurrency": "RUR",
30              "buy": 101.2,
31              "sell": 103.69
32            }
33          ]
34        },
35        {
36          "id": "MOGO",
37          "updatedAt": "2025-10-23T12:00:00.000Z",
38          "exchangeRates": [
39            {
40              "destinationCurrency": "USD",
41              "sourceCurrency": "RUR",
42              "buy": 92.3,
43              "sell": 93.79
44            },
45            {
46              "destinationCurrency": "EUR",
47              "sourceCurrency": "RUR",
48              "buy": 100.2,
49              "sell": 102.69
50            },
51            {
52              "destinationCurrency": "CNY",
53              "sourceCurrency": "RUR",
54              "buy": 30.2,
55              "sell": 31.69
56            }
57          ]
58        }
59      ]
60    }
61  ]
62}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_request – неверные входные параметры запроса
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_request",
3  "error_description": "Authorization header is not present in request headers"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_token – предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 401 (Unauthorized)
1{
2  "error": "invalid_token",
3  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • insufficient_scope – при запросе токена доступа не были переданы все необходимые scopes. Необходимо повторно отправить запрос на получение токена доступа с указанием всех доступных scopes
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 403 (Forbidden)
1{
2  "error": "insufficient_scope",
3  "error_description": "The request requires higher privileges than provided by the access token"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • unknown_endpoint – эндпоинт не найден или неактивен
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 404 (Not Found)
1{
2  "error": "unknown_endpoint",
3  "error_description": "Endpoint is not found or not active"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • internal_error – внутренняя ошибка сервиса при выполнении обработки запроса
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 500 (Internal Server Error)
1{
2  "error": "internal_error",
3  "error_description": "Internal server error"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • service_unavailable – сервис временно недоступен
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 503 (Service Unavailable)
1{
2  "error": "service_unavailable",
3  "error_description": "The service is temporarily unavailable"
4}