B2BH2H

Получение информации об оборотах

Песочница
GET https://sandbox.alfabank.ru/api/jp/v1/statement/summary
Пром
GET https://baas.alfabank.ru/api/jp/v1/statement/summary
Scope

transactions

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

application/json

QUERY
Атрибут
Описание
accountNumber
stringrequired

Номер расчётного счёта

statementDate
stringrequired

Дата исполнения операции в формате YYYY-MM-DD. Допустимы даты не ранее чем 5 лет назад от первого дня текущего года. Например, если сейчас 2026 год, то минимальная дата – 2021-01-01

Пример запроса
Язык
1curl --location --globoff 'https://baas.alfabank.ru/api/jp/v1/statement/summary?accountNumber={accountNumber}&statementDate={statementDate}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'
Параметры ответа
Пример ответа 200 (OK)
1{
2  "composedDateTime": "2018-12-31",
3  "lastMovementDate": "2018-12-31",
4  "openingRate": null,
5  "openingBalance": {
6    "amount": 10000.55,
7    "currencyName": "RUR"
8  },
9  "openingBalanceRub": {
10    "amount": 10000.55,
11    "currencyName": "RUR"
12  },
13  "closingBalance": {
14    "amount": 25000.3,
15    "currencyName": "RUR"
16  },
17  "closingBalanceRub": {
18    "amount": 25000.3,
19    "currencyName": "RUR"
20  },
21  "debitTurnover": {
22    "amount": 10000,
23    "currencyName": "RUR"
24  },
25  "DebitTurnoverRub": {
26    "amount": 10000,
27    "currencyName": "RUR"
28  },
29  "debitTransactionsNumber": 10,
30  "creditTransactionsNumber": 10,
31  "creditTurnover": {
32    "amount": 24999.75,
33    "currencyName": "RUR"
34  },
35  "creditTurnoverRub": {
36    "amount": 24999.75,
37    "currencyName": "RUR",
38    "creditTransactionsNumber": 10
39  }
40}
BODY
атрибут
описание
composedDateTime
stringoptional

Дата составления сводки

lastMovementDate
stringoptional

Дата последней операции по счёту за запрошенный период

openingRate
stringoptional

Курс ЦБ за единицу валюты на начало периода

objectoptional

Входящий остаток в валюте счёта

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

objectoptional

Входящий остаток в рублях

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

objectoptional

Исходящий остаток в валюте счёта

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

objectoptional

Исходящий остаток в рублях

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

objectoptional

Дебетовый оборот в валюте счёта

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

objectoptional

Дебетовый оборот в рублях

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

debitTransactionsNumber
integeroptional

Количество дебетовых операций по счёту

creditTransactionsNumber
integeroptional

Количество кредитовых операций по счёту

objectoptional

Кредитовый оборот в валюте счёта

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

objectoptional

Кредитовый оборот в рублях

amount
numberoptional

Сумма

currencyName
stringoptional

Буквенный ISO-код валюты

creditTransactionsNumber
integeroptional

Количество кредитовых операций по счёту

Пример ответа 200 (OK)
1{
2  "composedDateTime": "2018-12-31",
3  "lastMovementDate": "2018-12-31",
4  "openingRate": null,
5  "openingBalance": {
6    "amount": 10000.55,
7    "currencyName": "RUR"
8  },
9  "openingBalanceRub": {
10    "amount": 10000.55,
11    "currencyName": "RUR"
12  },
13  "closingBalance": {
14    "amount": 25000.3,
15    "currencyName": "RUR"
16  },
17  "closingBalanceRub": {
18    "amount": 25000.3,
19    "currencyName": "RUR"
20  },
21  "debitTurnover": {
22    "amount": 10000,
23    "currencyName": "RUR"
24  },
25  "DebitTurnoverRub": {
26    "amount": 10000,
27    "currencyName": "RUR"
28  },
29  "debitTransactionsNumber": 10,
30  "creditTransactionsNumber": 10,
31  "creditTurnover": {
32    "amount": 24999.75,
33    "currencyName": "RUR"
34  },
35  "creditTurnoverRub": {
36    "amount": 24999.75,
37    "currencyName": "RUR",
38    "creditTransactionsNumber": 10
39  }
40}
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 - предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам. При истечении срока жизни токена необходимо обновить его с помощью refresh_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 и параметра prompt=consent;
  • •
    insufficient_privileges - у пользователя нет прав на просмотр счёта;
  • •
    access_denied - доступ к счёту запрещён
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}
Нет тела ответа
stringoptional

Зашифрованное тело ответа

Пример зашифрованного ответа 200 (ОК)
1eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.q-wVNGV9BMuxdZCSD14GrHrue2YS1vO2MHUmfZM_fGudc03dYew7PY5FDD8soPE2rJz1xaplolkzNkJ1gLGYdiAaU6s1q8ZTIT3NqyyLRtUP0gkwD7JG9bZmDtHblVDZom7SqPw9FN28xvj8yIp-2kTpwRZDdJ7OYSUBUyBsFJj2hL9UVmZ-sJRY3D-WyVENn3-twsxlKOmikBrAWrKiFobjPFFyDj_9sJ4VrUnOii_ySoFM2Aw4TRReMAxtfxIu1COUfyNKfNaYnKI_wlkf8Pyfa3jDgdbLTNdmzplQX6krbZCq8NUQLsPn37_UuVjRxxGyZAkjxzF8gMVbQmA7cg.D2oikIYl4iA9w1Iw.AS6oGkk7e1BiGp1JaLAV4r1WxsMV9l02Gbc-txd36z4zXxI2SU_nBbTY__-9qOecApW89cc-qKFKuKpCDTVSJO43jmjFbW4GugVZJRQgzIab5gkkBZvw9naUzaiwDohbZJKJ-Tl49Ny4zCwIBEEhgJsAhtDVfsQTwq5lnADTHmWr5StSoB1kSac3vVEPp4g0RpHLIPhXQtQ0t9jzzny5ATOFTMWZrSk9huH5cNvohARlBnN-FFuOHhjY3stk5-xmejmopaawFhQX4_XJ5nokEt9lW3V0eDe6fiBam7hL9oOf5CkFPHVkuTGV4yF19GV9gHjQAz4DHFfh6M-btNQbrfbOl5cgcpHZqqVPIDXrNhMSRPQ57VOsQkn-dZzC4xw_frTMf-dnhncYfjnLwCFg8Y5zUaPJBH6oQE5ipeB0BPxjUCCD5rBPcds4oC4LVbFSnAeFt5n41tAGMMGZV-gL6VUMcZxicrOWlh6ST2TgD5RPWiSgnyl9lU5M6sdIRhDu20pidwLnPHDVowa50Wyfu510VTSuaHi3WDfjCItAoxGNDFOD8iNz3zylfgTuf4E69NcDHj82SJLlcFeF09DXyFhZLQnaVvjHeKCe0hICb_M7JY0jaL0cOrCNy6fSYm7qMY8Tzmv7nsSLm-GW0lr4-i16JmohPNprplOemoXQtqav2nVjnkJHCapayrNY6yOxcZVOYukosly9X3t7PcP88JH-pMPZGOMk2Umt1pfZ0Q1xqS_cRo_7LxBUiYBZ1XDxXcCQRxKd7TAZOWDTOKaXiKqhTBNpQ60ZBgNx4nT7iqXJqMKDxGsVsx2zraIX_tyfm6Z5xEDYwqc8wOw5k4Oh_nYzRKPS9WxcNUbJZKrUbpmldQqjj1YVP1hh8nDN5-H8sS2TXUlq6Wljam-zzQhU4gGfJ8EulVW0dhbY4QgHDEnNKu-01Tgi8mlmZk4M-IbcubE_o1UXSGcgYlIlGkrngh7G0vdkbYjbUgiDdGFi9FOIgqGZauMuuZ8mrLk6ZtgG8gUZRfv01GzUQw2Zx6GjMgDvi4W1yPBLyA1CgXYPLeMI6Avd9L9W4JPnwLiy3iD4K1K5RpFdOHStzrLurO_3A3SLdXF2htQST7ip8oliSMRDZ9QpBd7SAo3ZbAR9sSDkp6nl1NiR90EfGVflZTimIL6HqCvVKm1ydiwnnfWQN4hvaopQ8L7CVVcB5x7afZ8-Y2Kg4ls1wJdt7cQnoZDhqYohSsW_Vi6Frj6K7yMhXSqYWlwcsGj-lGhyS6wK4zv2YvHjZ3ERRoyfAmds0jfOyLgnduNhewJeDhHGIf-a4wwPDnCd99ljuDKWT6F9LljYxEOnieD4IRVJ9aFZFItI3t3QcgEWr6APg94rlQxjH2Rj17_vb-QdSjDaY48KJ2dVDx0SyfEF1AMVCGK60YYjo6bY6CciToHCCLY-98oIRLJ62-r9CIeMvvEZSqnZ9cIhspVOd7HEMJerbAjik4A3EG81_BHUmM5k6unO-lInI4WweWim84bOM6fHXPWS2zHJY4mPZFXoVvWGGbav05nIYzCQnhNvKhi5aObi8eOjInas3MPRHCfPCftWlDJu06PZ4aeFFS9cUsD4wHqZdvlaT4FRP0ogzfEJ2aCMUodMwwq5_g.Tr1eT11XVG3IiQkMIkS3Rg

 

Отправьте письмо на alfa_api@alfabank.ru, указав следующие данные:

  1. 1.
    client_id.
  2. 2.
    Дата и время запроса с указанием часового пояса.
  3. 3.
    Метод и URI запроса.
  4. 4.
    Заголовки и тело запроса.
  5. 5.
    Полученная ошибка и заголовки ответа, включая X-TraceId.
  6. 6.
    IP-адрес, с которого был отправлен запрос.
Получение выписки в формате MT940Получение выписки по корреспондентским счетам