Skip to content
Lumean API
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.

On this page(3)

Parameters

The inputs live inside the request line: fill in a value and you get a ready URL. Below are the type, whether it is required and the allowed values of every parameter.

GEThttps://api.lumean.app/api/public/reseller/statistics
  • stringin queryoptionaldate

    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.

  • stringin queryoptionaldate

    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.

Possible responses

200

Success. The payload is in data.

Body example
{
  "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
    }
  }
}
Response fields
successrequired

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
messagerequired

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
datarequired

The response payload.

object
periodrequired

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

object
fromrequired

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

date-time
string
torequired

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

date-time
string
moneyrequired

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

object
top_ups_countrequired

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

integer
topped_up_lmc_minorrequired

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

integer
topped_up_rub_lmc_minorrequired

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

integer
topped_up_crypto_lmc_minorrequired

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

string
topped_up_kopecksrequired

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

integer
refunds_countrequired

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

integer
refunded_kopecksrequired

The total of those refunds, in kopecks.

integer
issued_nominal_lmc_minorrequired

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

integer
issued_cost_lmc_minorrequired

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

integer
discount_given_lmc_minorrequired

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

string
cancelled_cost_lmc_minorrequired

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

integer
codesrequired

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

object
issuedrequired

How many codes were issued in the window.

integer
redeemedrequired

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

integer
activerequired

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

integer
cancelledrequired

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

integer
annulledrequired

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

integer
activation_raterequired

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.

nullable
number
avg_seconds_to_activationrequired

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

nullable
integer
by_nominalrequired

Issuing broken down by nominal, in ascending nominal order.

array<object>
array item
nominal_lmc_minorrequired

The nominal, minor LMC units.

integer
issuedrequired

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

integer
redeemedrequired

Of those, how many are redeemed.

integer
dailyrequired

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>
balancerequired

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

nullable
object
available_lmc_minorrequired

How much sits on the reseller’s account.

integer
held_lmc_minorrequired

How much is frozen.

integer
debt_lmc_minorrequired

The debt to the platform.

integer
spendable_lmc_minorrequired

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

nullable
object
rub_refundable_lmc_minorrequired

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

nullable
object
currency_assetrequired

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

object
coderequired

Code of the asset the amounts are expressed in.

ValuesLUMC
string
precisionrequired

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

integer
422

Validation error. Offending fields are listed in errors.

Analyse this response
Body example
{
  "message": "string",
  "errors": {}
}
Response fields
messagerequired

Errors overview.

string
errorsrequired

A detailed description of each field that failed validation.

object
*optional
arbitrary keys
array<string>

Feed this page to an AI

Open .mdllm.md

spec 0.0.1