Skip to content
Lumean
GET/reseller/codes/{uuid}

Show my gift code

One of your own codes with its full code value. Someone else's or a missing code gives 404 gift_code_not_found. Required key permission: reseller.read.

Parameters

Values go straight into the request line, and the URL is built for you. Below are each parameter’s type, whether it is required, and its allowed values.

GEThttps://api.lumean.app/api/public/reseller/codes/
  • stringin pathrequired

    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.

    The value goes straight into the request line above.

Possible responses

200

Success. The payload is in data.

Body example
{
  "data": {
    "uuid": "string",
    "code_masked": "string",
    "code": "string",
    "nominal": 1,
    "nominal_formatted": 1,
    "cost": 1,
    "cost_formatted": 1,
    "discount_bps": 1,
    "source": "purchase",
    "funding": "rub",
    "status": "active",
    "activatable_at": "2026-07-17T12:34:56+00:00",
    "redeemed_at": "2026-07-17T12:34:56+00:00",
    "cancelled_at": "2026-07-17T12:34:56+00:00",
    "created_at": "2026-07-17T12:34:56+00:00",
    "currency_asset": {
      "code": "string",
      "precision": 1
    }
  }
}
Response fields
datarequired

The response payload.

GiftCodeGiftCode
uuidrequired

Code UUID. Use it in the GET /reseller/codes/{uuid} and POST /reseller/codes/{uuid}/cancel paths.

string
code_maskedrequired

The code with a mask, LUM-****-****-XXXX: safe to show in a UI and to write to logs.

string
codeoptional

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.

string
nominalrequired

The code’s nominal value in minor LMC units: real = nominal / 10^currency_asset.precision. This is how much LMC the redeemer receives.

integer
nominal_formattedrequired

The same nominal value in whole LMC — a number ready to display.

number
costoptional

What the code cost the reseller after the discount, in minor LMC units. Present only for reseller codes (source: reseller).

integer
cost_formattedoptional

The same cost in whole LMC. Present only for reseller codes.

number
discount_bpsoptional

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.

integer
sourcerequired

Where the code came from: bought by a user with money (purchase) or issued by a reseller from their own balance (reseller).

Valuespurchaseresellersystem
GiftCodeSourceGiftCodeSource
fundingrequired

What paid for the code: roubles (rub), crypto (crypto) or both (mixed — a reseller code issued from a balance topped up both ways).

Valuesrubcryptomixedadmin
GiftCodeFundingGiftCodeFunding
statusrequired

Gift code status: active — issued and awaiting redemption (possibly still frozen until activatable_at); refunding — a refund is in progress, redemption and cancellation are unavailable; redeemed — redeemed, the nominal is on the redeemer's balance; refunded — the money went back to the buyer's card; cancelled — the reseller cancelled the code and the cost returned to their balance; annulled — annulled with no refund.

Valuesactiverefundingredeemedrefundedcancelledannulled
GiftCodeStatusGiftCodeStatus
activatable_atrequired

The moment from which the code can be redeemed; until then it is frozen. null means no restriction.

nullabledate-time
string
redeemed_atrequired

When the code was redeemed. null until it is. The API never reveals who redeemed it.

nullabledate-time
string
cancelled_atrequired

When the reseller cancelled the code. null if it was not cancelled.

nullabledate-time
string
created_atrequired

When the code was issued.

nullabledate-time
string
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

This page for AI

Open .mdllm.md

API version 1.0.0