Получение транзакций пользователя

GET

/v1/users/{userId}/transactions

Метод позволяет получить список транзакций пользователя, начиная с указанной даты. Транзакции включают информацию о списаниях средств за отправленные сообщения и другие операции, связанные с использованием платформы.

Авторизация

Для доступа к методу необходим токен системного пользователя. Передайте его в заголовке HTTP-запроса.

Authorization: Bearer <ACCESS_TOKEN>

Параметры

Параметр	Расположение	Тип	Обязательный	Описание
userId	Path	string	Да	Уникальный идентификатор системного пользователя.
start_date	Query	string	Да	Дата начала периода в формате YYYY-MM-DD.

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

curl -X GET \
  https://space.getloo.ru/api/v1/users/{userId}/transactions?start_date=2025-11-20 \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json"

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

[
  {
    "id": "6949404bfb7e3563a5dbdccf",
    "app_id": 1,
    "amount": -2.1,
    "currency": "RUB",
    "status": "DELIVERED",
    "category": "MARKETING",
    "recipient_phone": "79991234567",
    "timestamp": 1766408267
  }
]

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

Параметр	Тип	Описание
id	string	Уникальный идентификатор транзакции.
app_id	number	Уникальный идентификатор приложения.
amount	number	Сумма списания.
currency	string	Валюта списания.
status	string	Статус транзакции. Возможные значения: DELIVERED — доставлено READ — прочитано FAILED — ошибка
category	string	Категория сообщения. Возможные значения: MARKETING — маркетинговое сообщение UTILITY — утилитное сообщение SERVICE — сервисное сообщение
recipient_phone	string	Номер телефона пользователя в международном формате.
timestamp	number	Временная метка транзакции в Unix time.

Коды состояния

Код состояния	Описание
200	Запрос успешно выполнен
401	Неавторизованный запрос
403	Доступ запрещён
429	Превышен лимит запросов