Получение списка денежных операций бенефициара

Песочница

GET https://sandbox.alfabank.ru/api/na/jp/v1/beneficiaries/{beneficiaryId}/transactions

Пром

GET https://baas.alfabank.ru/api/na/jp/v1/beneficiaries/{beneficiaryId}/transactions

Scope

beneficiaries

Описание

Метод позволяет получить список денежных операций бенефициара за заданный период по beneficiaryId.

Параметры запроса

HEADERS

Атрибут

Описание

Authorization

stringrequired

Bearer {access_token}, полученный по Authorization Code Flow H2H

stringrequired

application/json

QUERY

Атрибут

Описание

limit

integerrequired

Количество объектов на одной странице

offset

integerrequired

Количество объектов в списке, которые необходимо пропустить

dateFrom

stringrequired

Дата начала выборки

dateTo

stringrequired

Дата конца выборки

PATH

Атрибут

Описание

beneficiaryId

stringrequired

Идентификатор бенефициара

Пример запроса

Язык

1curl --location --globoff 'https://baas.alfabank.ru/api/na/jp/v1/beneficiaries/{beneficiaryId}/transactions?limit={limit}&offset={offset}&dateFrom=2024-01-01&dateTo=2024-01-01' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'

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

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

1{
2  "pagination": {
3    "limit": 100,
4    "offset": 0,
5    "totalCount": 10000
6  },
7  "transactionsList": [
8    {
9      "type": "Пополнение",
10      "amount": "10.00",
11      "timestamp": "2026-01-20T11:21:06.669Z",
12      "comment": "Ручное выравнивание баланса"
13    }
14  ]
15}

BODY

атрибут

описание

objectoptional

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

limit

numberoptional

Количество записей на одной странице

offset

numberoptional

Количество записей в списке, которые были пропущены

totalCount

numberoptional

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

array of objectsoptional

Список операций

type

stringrequired

Тип операции. Принимает возможные значения:

•

Пополнение - увеличение денежных средств бенефициара на номинальном счёте;
•

Вывод - уменьшение денежных средств бенефициара на номинальном счёте;
•

Заморозка - холдирование денежных средств бенефициара на номинальном счёте;
•

Разморозка - расхолдирование замороженных денежных средств бенефициара на номинальном счёте;
•

Исходящий перевод - перевод денежных средств другому бенефициару;
•

Входящий перевод - поступление денежных средств от другого бенефициара

amount

stringrequired

Сумма операции в рублях

timestamp

stringoptional

Дата и время проведения операции в формате ISO8601

comment

stringoptional

Комментарий к операции

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

1{
2  "pagination": {
3    "limit": 100,
4    "offset": 0,
5    "totalCount": 10000
6  },
7  "transactionsList": [
8    {
9      "type": "Пополнение",
10      "amount": "10.00",
11      "timestamp": "2026-01-20T11:21:06.669Z",
12      "comment": "Ручное выравнивание баланса"
13    }
14  ]
15}

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 и параметра prompt=consent

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}

Нет тела ответа