GET/ledger-transactions

Список транзакций

История движений средств владельца ключа: пополнения, списания за выполненные заказы, возвраты, реферальные начисления. Свежие сверху, постранично.

billing.read

Суммы — в минимальных единицах актива (см. precision), знак определяется направлением записи. Полный объект кошелька в публичной выдаче не отдаётся — остаётся wallet_id.

Эндпоинт существует только при включённом кошельке; в модели «без аванса» его нет (404).

Требуемое право ключа: billing.read.

На этой странице(3)

Параметры

Значения подставляются прямо в строку запроса, и URL собирается сам. Ниже — тип, обязательность и допустимые значения каждого параметра.

GEThttps://api.lumean.app/api/public/ledger-transactions

pageintegerв queryнеобязательный≥ 1
Номер страницы, начиная с 1.
per_pageintegerв queryнеобязательный1..100
Записей на странице, 1..100. По умолчанию 15.
wallet_idintegerв queryнеобязательный
Показать движения только по одному кошельку. Идентификаторы — в GET /wallets.
typeLedgerTransactionTypeв queryнеобязательный
Фильтр по типу движения средств. Полный перечень допустимых значений приходит в схеме LedgerTransactionType; чаще всего нужны deposit (пополнение), order_completion (списание за выполненный заказ), order_refund (возврат), referral_reward (реферальное начисление).

Неизвестное значение → 422.
Допустимые значения
sort_bystringв queryнеобязательный≤ 32 симв.
Поле сортировки. По умолчанию — дата операции. Неизвестное значение не ошибка: выдача просто вернётся к сортировке по дате, от новых к старым.
sort_orderstringв queryнеобязательный≤ 4 симв.
Направление сортировки. По умолчанию desc — свежие операции сверху.
Допустимые значения

Возможные ответы

200

Список транзакций

Пример тела

{
  "success": true,
  "message": "string",
  "data": {
    "items": [
      {
        "id": "string",
        "type": "string",
        "status": "string",
        "description": "string",
        "amount": "string",
        "amount_formatted": 1,
        "asset": {
          "id": 1,
          "code": "string",
          "kind": null,
          "precision": 1,
          "name": null,
          "is_active": true,
          "is_default": true,
          "default_balance": 1,
          "deleted_at": "2026-07-17T12:34:56+00:00",
          "created_at": "2026-07-17T12:34:56+00:00",
          "updated_at": "2026-07-17T12:34:56+00:00"
        },
        "direction": "string",
        "created_at": "string",
        "entries": [
          {
            "id": null,
            "wallet_id": null,
            "amount": null,
            "amount_formatted": null,
            "asset": null,
            "entry_type": null,
            "metadata": null,
            "created_at": null,
            "wallet": null
          }
        ],
        "actor_user_id": "string",
        "metadata": "string"
      }
    ],
    "current_page": 1,
    "last_page": 1,
    "per_page": 1,
    "total": 1
  }
}

Поля ответа

successобязательное

Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь true, а ошибка приходит телом другой формы, где этого поля может не быть вовсе.

boolean

messageобязательное

Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются.

string

dataобязательное

Полезная нагрузка ответа.

LedgerTransactionListLedgerTransactionList

itemsобязательное

Записи текущей страницы в порядке сортировки списка.

array<LedgerTransaction>LedgerTransaction

элемент массива

idобязательное

ID движения средств.

integer

typeобязательное

Тип движения — значение LedgerTransactionType: deposit (пополнение), order_completion (списание за заказ), order_refund (возврат), policy_block_fee (плата за попытку, отклонённую контентной политикой) и др.

Значенияreferral_rewardinitial_depositdepositunlock_balancelock_balanceadmin_adjustmenttransfertransfer_feesubscription_refundadmin_subscription_grantdeposit_refundadmin_chargeadmin_creditmigration_creditorder_completionorder_refundsubscription_direct_paymenttoken_consumption_chargedeposit_bonusreferral_reward_usdreferral_reward_reversalsubscription_renewalsubscription_token_consumedsubscription_token_refundsubscription_token_forfeitedsubscription_token_creditlegacy_balance_migrationpolicy_block_feeai_gateway_usagegift_code_purchasegift_code_issuegift_code_cancelgift_code_redemptiongift_code_self_redemptiongift_code_discountgift_code_refundreseller_top_upreseller_top_up_refundreseller_debt_repaymentreseller_revoke_transfer

LedgerTransactionTypeLedgerTransactionType

statusобязательное

Состояние движения: posted — проведено, pending — ожидает проведения, void — аннулировано и на баланс не влияет.

Значенияpendingpostedvoid

string

descriptionобязательное

Описание движения словами, для показа. null, если описания нет.

может быть null

string

amountнеобязательное

Сумма движения целым числом в minor units актива (asset.precision), без знака — направление в direction. Нет, если сумму определить нельзя.

integer

amount_formattedнеобязательное

Та же сумма в целых единицах актива — готова к показу. Приходит, только когда актив суммы известен (у движений по кошельку его нет — делитель берите из asset.precision кошелька entries[].wallet_id в GET /wallets).

number

assetнеобязательное

Актив суммы; его precision — делитель для amount. Приходит при тех же условиях, что amount_formatted.

AssetAsset

idобязательное

Внутренний идентификатор актива.

integer

codeобязательное

Код актива: LUMC — внутренняя валюта, TOKEN — токены генерации.

string

kindобязательное

Вид актива: деньги или расходуемые единицы. От него зависит, где сумма считается платежом, а где — расходом квоты.

Значенияmoneyunit

AssetKindAssetKind

precisionобязательное

Число десятичных знаков. Ключевое поле: любая целая сумма этого актива делится на 10^precision, чтобы получить реальное значение. Не считайте, что делитель равен 100.

integer

nameобязательное

Название актива для показа, на языке аккаунта.

string

deleted_atобязательное

Когда актив выведен из обращения, ISO 8601. null у действующего.

может быть nulldate-time

string

created_atобязательное

Когда актив заведён, ISO 8601.

может быть nulldate-time

string

updated_atобязательное

Когда актив последний раз менялся, ISO 8601.

может быть nulldate-time

string

directionнеобязательное

credit — зачисление вам, debit — списание. Исключение — блокировка и разблокировка под заказ (type: lock_balance, unlock_balance): деньги не покидают кошелёк, обе проводки на нём, и direction смысла не несёт — ориентируйтесь на type.

Значенияdebitcredit

string

created_atобязательное

Когда движение создано, ISO 8601.

string

entriesнеобязательное

Проводки по вашим кошелькам. У движения мимо кошелька (например, прямая оплата подписки) — пустой список, сумма тогда в полях самой транзакции.

array<LedgerEntry>LedgerEntry

элемент массива

idобязательное

ID проводки.

integer

wallet_idобязательное

Кошелёк проводки — id из GET /wallets.

integer

amountобязательное

Сумма проводки целым числом в minor units актива кошелька (делитель — asset.precision кошелька wallet_id в GET /wallets); направление — в entry_type.

integer

entry_typeобязательное

credit — зачисление на кошелёк, debit — списание с него.

Значенияcreditdebit

string

created_atобязательное

Когда проводка создана, ISO 8601.

string

current_pageобязательное

Номер текущей страницы, с единицы.

integer

last_pageобязательное

Номер последней страницы. Обход списка закончен, когда current_page равен last_page.

integer

per_pageобязательное

Размер страницы, применённый сервером.

integer

totalобязательное

Сколько записей всего по фильтру.

integer

401

Невалидный или отсутствующий API-ключ

Разобрать этот ответ

Пример тела

{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}

Поля ответа

successобязательное

Всегда false в ответах об ошибке.

boolean

messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string

dataобязательное

Всегда null, когда запрос отклонён до обработки.

может быть null

null

403

У ключа нет права billing.read

Разобрать этот ответ

Пример тела

{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}

Поля ответа

successобязательное

Всегда false в ответах об ошибке.

boolean

messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string

422

Ошибка валидации. Поля с ошибками перечислены в errors.

Разобрать этот ответ

Пример тела

{
  "success": true,
  "message": "string",
  "errors": {}
}

Поля ответа

successобязательное

Всегда false в ответах об ошибке.

boolean

messageобязательное

Сводка ошибок валидации словами, на языке ответа (X-Locale).

string

errorsобязательное

Разбор по полям: ключ — поле запроса, значение — список претензий к нему.

object

*необязательное

произвольные ключи

array<string>

Объекты

Соседние операции

Ещё

Эта страница для ИИ

Открыть .md llm.md

версия API 1.0.0

Параметры

Возможные ответы

Рядом

Эта страница для ИИ