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

# GET /reseller/settings

**Gift code settings**

Preset nominals (LMC decimal strings), the bounds for a custom nominal and the reseller self-cancel window (`reseller_cancel_window_minutes`). The cap on codes per issue is in the profile. **Key permission:** `reseller.read`.

- Required scope: `reseller.read`

## Request

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

## Parameters

No parameters.

## Request body

No body.

## Responses

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

**Response fields**

| Field | Type | Req. | Description |
| --- | --- | --- | --- |
| `nominals` | `array<string>` | required | Preset code nominals in LMC — decimal strings without trailing zeros (`"100"`, `"2.5"`). `POST /reseller/codes` accepts any value between `min_nominal` and `max_nominal`, not only those from this list. |
| `min_nominal` | `string` | required | The smallest allowed nominal of a single code, LMC (decimal string). |
| `max_nominal` | `string` | required | The largest allowed nominal of a single code, LMC (decimal string). |
| `max_codes_per_purchase` | `integer` | required | How many codes an ordinary buyer may take in one purchase. It does not apply to reseller issuing: that ceiling is `limits.max_codes_per_issue` in `GET /reseller`. |
| `max_purchase_rub` | `integer` | required | The ceiling of a single roubles purchase of codes by an ordinary buyer, in roubles. |
| `hold_hours` | `integer` | required | For how many hours a code bought with roubles stays frozen for redemption (the code’s `activatable_at` field). |
| `reseller_cancel_window_minutes` | `integer` | required | The reseller’s self-cancel window, in minutes since issue: while it is open, `POST /reseller/codes/{uuid}/cancel` returns the cost to the balance. |
| `rub_enabled` | `boolean` | required | Whether code purchases with roubles are enabled. It does not affect issuing from the reseller balance. |
| `currency_asset` | `object` | required | The currency of the amounts in the response — LMC. Use `precision` to convert amounts in minor units into whole LMC. |
| `currency_asset.code` | `string` | required | Code of the asset the amounts are expressed in. |
| `currency_asset.precision` | `integer` | required | How many decimals LMC has: `real = value / 10^precision`. |

**Example**

```json
{
  "nominals": [
    "string"
  ],
  "min_nominal": "string",
  "max_nominal": "string",
  "max_codes_per_purchase": 1,
  "max_purchase_rub": 1,
  "hold_hours": 1,
  "reseller_cancel_window_minutes": 1,
  "rub_enabled": true,
  "currency_asset": {
    "code": "string",
    "precision": 1
  }
}
```

---

- This page in the browser: https://lumean.app/en/developers/docs/api/get-reseller-settings
- Full machine-readable reference: https://api.lumean.app/docs/llm.md