---
title: "GET /reseller/statistics — Reseller statistics"
url: https://lumean.app/de/developers/docs/api/get-reseller-statistics
locale: de
description: "Reseller statistics"
generated: 2026-10-17
operationId: reseller.statistics
method: GET
path: /reseller/statistics
scopes: [reseller.read]
spec_version: 0.0.1
---

# 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`.

- Benötigtes Recht: `reseller.read`

## Anfrage

```bash
curl -X GET 'https://api.lumean.app/api/public/reseller/statistics' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'
```

## Parameter

| Feld | In | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- | --- |
| `from` | query | `string` — 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`. |
| `to` | query | `string` — 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. |

## Request-Body

Kein Body.

## Antworten

### 200 — Success. The payload is in `data`.

**Antwortfelder**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `success` | `boolean` | Pflicht | 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. |
| `message` | `string` | Pflicht | 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. |
| `data` | `object` | Pflicht | The response payload. |
| `data.period` | `object` | Pflicht | The window the statistics cover: the `from`/`to` bounds (the last 30 days by default) in the `X-Timezone` zone. |
| `data.period.from` | `string` — date-time | Pflicht | Start of the window — the start of the `from` day. |
| `data.period.to` | `string` — date-time | Pflicht | End of the window — the end of the `to` day. |
| `data.money` | `object` | Pflicht | Money over the window. LMC amounts are in minor units (`real = value / 10^currency_asset.precision`), roubles are in kopecks. |
| `data.money.top_ups_count` | `integer` | Pflicht | How many balance top-ups were confirmed in the window. |
| `data.money.topped_up_lmc_minor` | `integer` | Pflicht | Total top-ups in the window, minor LMC units: roubles and crypto together. |
| `data.money.topped_up_rub_lmc_minor` | `integer` | Pflicht | The part of the top-ups paid in roubles, in minor LMC units. |
| `data.money.topped_up_crypto_lmc_minor` | `string` | Pflicht | The part of the top-ups paid in crypto, in minor LMC units. |
| `data.money.topped_up_kopecks` | `integer` | Pflicht | Roubles top-ups in kopecks — exactly what was paid to the provider. |
| `data.money.refunds_count` | `integer` | Pflicht | How many refunds of the roubles balance to a card were made in the window. |
| `data.money.refunded_kopecks` | `integer` | Pflicht | The total of those refunds, in kopecks. |
| `data.money.issued_nominal_lmc_minor` | `integer` | Pflicht | The sum of nominals of the codes issued in the window, in minor LMC units. |
| `data.money.issued_cost_lmc_minor` | `integer` | Pflicht | What those codes cost the reseller (after the discount), in minor LMC units. |
| `data.money.discount_given_lmc_minor` | `string` | Pflicht | The discount over the window: the sum of nominals minus the cost of the issued codes, in minor LMC units. |
| `data.money.cancelled_cost_lmc_minor` | `integer` | Pflicht | The cost of codes cancelled in the window and returned to the balance, in minor LMC units. |
| `data.codes` | `object` | Pflicht | Codes ISSUED in the window and what became of them as of the request. |
| `data.codes.issued` | `integer` | Pflicht | How many codes were issued in the window. |
| `data.codes.redeemed` | `integer` | Pflicht | Of those issued in the window, how many are already redeemed. |
| `data.codes.active` | `integer` | Pflicht | Of those issued in the window, how many still await redemption. |
| `data.codes.cancelled` | `integer` | Pflicht | Of those issued in the window, how many the reseller cancelled. |
| `data.codes.annulled` | `integer` | Pflicht | Of those issued in the window, how many the platform annulled without a refund of the cost. |
| `data.codes.activation_rate` | `number` — nullable | Pflicht | 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. |
| `data.codes.avg_seconds_to_activation` | `integer` — nullable | Pflicht | Average time from issue to redemption, in seconds. `null` when nothing was redeemed. |
| `data.by_nominal` | `array<object>` | Pflicht | Issuing broken down by nominal, in ascending nominal order. |
| `data.by_nominal[].nominal_lmc_minor` | `integer` | Pflicht | The nominal, minor LMC units. |
| `data.by_nominal[].issued` | `integer` | Pflicht | How many codes of this nominal were issued in the window. |
| `data.by_nominal[].redeemed` | `integer` | Pflicht | Of those, how many are redeemed. |
| `data.daily` | `array<any>` | Pflicht | 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. |
| `data.balance` | `object` — nullable | Pflicht | The balance as of the request — not for the window. Amounts are in minor LMC units. |
| `data.balance.available_lmc_minor` | `integer` | Pflicht | How much sits on the reseller’s account. |
| `data.balance.held_lmc_minor` | `integer` | Pflicht | How much is frozen. |
| `data.balance.debt_lmc_minor` | `integer` | Pflicht | The debt to the platform. |
| `data.balance.spendable_lmc_minor` | `object` — nullable | Pflicht | How much can be spent on issuing: the available balance minus the debt, never below zero. |
| `data.balance.rub_refundable_lmc_minor` | `object` — nullable | Pflicht | The part of the balance backed by roubles that can be refunded to a card (net of the debt). |
| `data.currency_asset` | `object` | Pflicht | The currency of the amounts in the response — LMC. Use `precision` to convert amounts in minor units into whole LMC. |
| `data.currency_asset.code` | `string` — `LUMC` | Pflicht | Code of the asset the amounts are expressed in. |
| `data.currency_asset.precision` | `integer` | Pflicht | How many decimals LMC has: `real = value / 10^precision`. |

**Beispiel**

```json
{
  "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
    }
  }
}
```

### 422 — Validation error. Offending fields are listed in `errors`.

**Antwortfelder**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `message` | `string` | Pflicht | Errors overview. |
| `errors` | `object` | Pflicht | A detailed description of each field that failed validation. |
| `errors.*` | `array<string>` — beliebige Schlüssel | — |  |

**Beispiel**

```json
{
  "message": "string",
  "errors": {}
}
```

---

- Diese Seite im Browser: https://lumean.app/de/developers/docs/api/get-reseller-statistics
- Vollständige maschinenlesbare Referenz: https://api.lumean.app/docs/llm.md