İçeriğe geç
Lumean API

Açıklamalar İngilizce

Bölümün arayüzü dilinize çevrildi, ancak işlem, şema ve hata açıklamaları yalnızca Rusça ve İngilizce mevcut — burada İngilizce sürüm gösteriliyor.
GET/reseller/statistics

Reseller statistics

Statistics for the from–to window (Y-m-d dates in the X-Timezone zone, UTC without the header; the last 30 days by default): money, codes, a breakdown by nominal, a per-day series. Key permission: reseller.read.

Bu sayfada(3)

Parametreler

Giriş alanları doğrudan istek satırında yer alır: bir değer girin, hazır URL'yi alın. Aşağıda her parametrenin türü, zorunlu olup olmadığı ve izin verilen değerleri var.

GEThttps://api.lumean.app/api/public/reseller/statistics
  • stringsorgudaisteğe bağlıdate

    First day of the statistics window — a calendar date Y-m-d in the X-Timezone zone (UTC without the header). Omitted — 30 days before to.

  • stringsorgudaisteğe bağlıdate

    Last day of the window — a calendar date Y-m-d in the X-Timezone zone, not earlier than from; the whole day is included. Omitted — today.

Olası yanıtlar

200

Success. The payload is in data.

Gövde örneği
{
  "success": true,
  "message": "string",
  "data": {
    "period": {
      "from": "2026-07-17T12:34:56+00:00",
      "to": "2026-07-17T12:34:56+00:00"
    },
    "money": {
      "top_ups_count": 1,
      "topped_up_lmc_minor": 1,
      "topped_up_rub_lmc_minor": 1,
      "topped_up_crypto_lmc_minor": "string",
      "topped_up_kopecks": 1,
      "refunds_count": 1,
      "refunded_kopecks": 1,
      "issued_nominal_lmc_minor": 1,
      "issued_cost_lmc_minor": 1,
      "discount_given_lmc_minor": "string",
      "cancelled_cost_lmc_minor": 1
    },
    "codes": {
      "issued": 1,
      "redeemed": 1,
      "active": 1,
      "cancelled": 1,
      "annulled": 1,
      "activation_rate": 1,
      "avg_seconds_to_activation": 1
    },
    "by_nominal": [
      {
        "nominal_lmc_minor": 1,
        "issued": 1,
        "redeemed": 1
      }
    ],
    "daily": [
      "string"
    ],
    "balance": {
      "available_lmc_minor": 1,
      "held_lmc_minor": 1,
      "debt_lmc_minor": 1,
      "spendable_lmc_minor": [],
      "rub_refundable_lmc_minor": []
    },
    "currency_asset": {
      "code": "string",
      "precision": 1
    }
  }
}
Yanıt alanları
successzorunlu

Success flag. Branch on the HTTP status code instead: any 2xx response carries true here, while an error comes back in a different shape that need not contain this field at all.

boolean
messagezorunlu

A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code.

string
datazorunlu

The response payload.

object
periodzorunlu

The window the statistics cover: the from/to bounds (the last 30 days by default) in the X-Timezone zone.

object
fromzorunlu

Start of the window — the start of the from day.

date-time
string
tozorunlu

End of the window — the end of the to day.

date-time
string
moneyzorunlu

Money over the window. LMC amounts are in minor units (real = value / 10^currency_asset.precision), roubles are in kopecks.

object
top_ups_countzorunlu

How many balance top-ups were confirmed in the window.

integer
topped_up_lmc_minorzorunlu

Total top-ups in the window, minor LMC units: roubles and crypto together.

integer
topped_up_rub_lmc_minorzorunlu

The part of the top-ups paid in roubles, in minor LMC units.

integer
topped_up_crypto_lmc_minorzorunlu

The part of the top-ups paid in crypto, in minor LMC units.

string
topped_up_kopeckszorunlu

Roubles top-ups in kopecks — exactly what was paid to the provider.

integer
refunds_countzorunlu

How many refunds of the roubles balance to a card were made in the window.

integer
refunded_kopeckszorunlu

The total of those refunds, in kopecks.

integer
issued_nominal_lmc_minorzorunlu

The sum of nominals of the codes issued in the window, in minor LMC units.

integer
issued_cost_lmc_minorzorunlu

What those codes cost the reseller (after the discount), in minor LMC units.

integer
discount_given_lmc_minorzorunlu

The discount over the window: the sum of nominals minus the cost of the issued codes, in minor LMC units.

string
cancelled_cost_lmc_minorzorunlu

The cost of codes cancelled in the window and returned to the balance, in minor LMC units.

integer
codeszorunlu

Codes ISSUED in the window and what became of them as of the request.

object
issuedzorunlu

How many codes were issued in the window.

integer
redeemedzorunlu

Of those issued in the window, how many are already redeemed.

integer
activezorunlu

Of those issued in the window, how many still await redemption.

integer
cancelledzorunlu

Of those issued in the window, how many the reseller cancelled.

integer
annulledzorunlu

Of those issued in the window, how many the platform annulled without a refund of the cost.

integer
activation_ratezorunlu

The share of redeemed codes among those issued in the window, from 0 to 1 (4 decimals). null when nothing was issued in the window.

null olabilir
number
avg_seconds_to_activationzorunlu

Average time from issue to redemption, in seconds. null when nothing was redeemed.

null olabilir
integer
by_nominalzorunlu

Issuing broken down by nominal, in ascending nominal order.

array<object>
dizi öğesi
nominal_lmc_minorzorunlu

The nominal, minor LMC units.

integer
issuedzorunlu

How many codes of this nominal were issued in the window.

integer
redeemedzorunlu

Of those, how many are redeemed.

integer
dailyzorunlu

A per-day series in the X-Timezone zone, ascending by date. An element: date (Y-m-d), issued, redeemed, topped_up_lmc_minor (top-ups, minor LMC units). Days without events are left out.

array<any>
balancezorunlu

The balance as of the request — not for the window. Amounts are in minor LMC units.

null olabilir
object
available_lmc_minorzorunlu

How much sits on the reseller’s account.

integer
held_lmc_minorzorunlu

How much is frozen.

integer
debt_lmc_minorzorunlu

The debt to the platform.

integer
spendable_lmc_minorzorunlu

How much can be spent on issuing: the available balance minus the debt, never below zero.

null olabilir
object
rub_refundable_lmc_minorzorunlu

The part of the balance backed by roubles that can be refunded to a card (net of the debt).

null olabilir
object
currency_assetzorunlu

The currency of the amounts in the response — LMC. Use precision to convert amounts in minor units into whole LMC.

object
codezorunlu

Code of the asset the amounts are expressed in.

DeğerlerLUMC
string
precisionzorunlu

How many decimals LMC has: real = value / 10^precision.

integer
422

Validation error. Offending fields are listed in errors.

Bu yanıtı çözümle
Gövde örneği
{
  "message": "string",
  "errors": {}
}
Yanıt alanları
messagezorunlu

Errors overview.

string
errorszorunlu

A detailed description of each field that failed validation.

object
*isteğe bağlı
rastgele anahtarlar
array<string>

Bu sayfayı yapay zekâya verin

.md sürümünü açllm.md

spesifikasyon 0.0.1