---
title: "POST /reseller/codes/{uuid}/cancel — Cancel my gift code"
url: https://lumean.app/de/developers/docs/api/post-reseller-codes-uuid-cancel
locale: de
description: "Cancel my gift code"
generated: 2026-10-17
operationId: reseller.cancelCode
method: POST
path: "/reseller/codes/{uuid}/cancel"
scopes: [reseller.write]
spec_version: 0.0.1
---

# POST /reseller/codes/{uuid}/cancel

**Cancel my gift code**

Cancels an unredeemed reseller code within the window after issue (`reseller_cancel_window_minutes` from the settings); the cost returns to the reseller balance. Outside the window — `409` `gift_code_cancel_window_expired`; already redeemed or cancelled — `409` `gift_code_not_cancellable`. **Key permission:** `reseller.write`.

- Benötigtes Recht: `reseller.write`

## Anfrage

```bash
curl -X POST 'https://api.lumean.app/api/public/reseller/codes/{uuid}/cancel' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'
```

## Parameter

| Feld | In | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- | --- |
| `uuid` | path | `string` | Pflicht | Gift code UUID — 36 characters, not the `LUM-…` code itself. Take it from the `uuid` field: `POST /reseller/codes` returns it on issue and `GET /reseller/codes` lists it. Someone else's or a missing code returns `404` with `reason: gift_code_not_found`. default: `0199b3a4-7c21-7d4e-9a8b-5f6e7d8c9b0a` |

## Request-Body

Kein Body.

## Antworten

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

**Antwortfelder**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `data` | `GiftCode` | Pflicht | The response payload. |
| `data.uuid` | `string` | Pflicht | Code UUID. Use it in the `GET /reseller/codes/{uuid}` and `POST /reseller/codes/{uuid}/cancel` paths. |
| `data.code_masked` | `string` | Pflicht | The code with a mask, `LUM-****-****-XXXX`: safe to show in a UI and to write to logs. |
| `data.code` | `string` | — | The FULL code value — what the recipient types to redeem it. The reseller public API returns it in the list, on show and on issue. Treat it as a secret: whoever knows the code can redeem it. |
| `data.nominal` | `string` | Pflicht | The code’s nominal value in minor LMC units: `real = nominal / 10^currency_asset.precision`. This is how much LMC the redeemer receives. |
| `data.nominal_formatted` | `number` | Pflicht | The same nominal value in whole LMC — a number ready to display. |
| `data.cost` | `string` | — | What the code cost the reseller after the discount, in minor LMC units. Present only for reseller codes (`source: reseller`). |
| `data.cost_formatted` | `number` | — | The same cost in whole LMC. Present only for reseller codes. |
| `data.discount_bps` | `integer` | — | The reseller’s discount at the moment of issue, in basis points (`100` = 1%). A later change of the personal discount does not affect this code. Present only for reseller codes. |
| `data.source` | `string` | Pflicht |  |
| `data.funding` | `string` | Pflicht |  |
| `data.status` | `string` | Pflicht |  |
| `data.activatable_at` | `string` | Pflicht | The moment from which the code can be redeemed; until then it is frozen. `null` means no restriction. |
| `data.redeemed_at` | `string` | Pflicht | When the code was redeemed. `null` until it is. The API never reveals who redeemed it. |
| `data.cancelled_at` | `string` | Pflicht | When the reseller cancelled the code. `null` if it was not cancelled. |
| `data.created_at` | `string` | Pflicht | When the code was issued. |
| `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
{
  "data": {
    "uuid": "string",
    "code_masked": "string",
    "code": "string",
    "nominal": "string",
    "nominal_formatted": 1,
    "cost": "string",
    "cost_formatted": 1,
    "discount_bps": 1,
    "source": "string",
    "funding": "string",
    "status": "string",
    "activatable_at": "string",
    "redeemed_at": "string",
    "cancelled_at": "string",
    "created_at": "string",
    "currency_asset": {
      "code": "string",
      "precision": 1
    }
  }
}
```

---

- Diese Seite im Browser: https://lumean.app/de/developers/docs/api/post-reseller-codes-uuid-cancel
- Vollständige maschinenlesbare Referenz: https://api.lumean.app/docs/llm.md