ItemLookupRow

error object

anyOf

• string
• null

string

Possible values: [service_not_found, item_not_found, upstream_error]

foundFoundrequired

item object

anyOf

• ProductItem
• null

amountIsQuantityAmountisquantity

true when the item is a quantity-mode DTU (e.g. Telegram Stars, TON). The amount value sent in POST /orders and POST /dtu/validation must then be an integer count of units.

Default value: false

currencyCurrencyrequired

idIdrequired

inStockInstockrequired

isLongOrder object

Whether long orders are supported for this item. When true, you may set isLongOrder=true in POST /orders (shop orders only).

anyOf

• boolean
• null

boolean

maxQuantity object

Maximum allowed quantity. Present only when amountIsQuantity=true.

anyOf

• integer
• null

integer

minQtyToLongOrder object

Minimum quantity for which a long order is allowed. Present only when isLongOrder=true.

anyOf

• integer
• null

integer

minQuantity object

Minimum allowed quantity. Present only when amountIsQuantity=true.

anyOf

• integer
• null

integer

name object

anyOf

• string
• null

string

pricePricerequired

stepQuantity object

Allowed step between quantities. Present only when amountIsQuantity=true.

anyOf

• integer
• null

integer

unitPrice object

Per-unit base price in USD. Present only when amountIsQuantity=true; final price is computed as quantity × unitPrice (plus any tariff markup).

anyOf

• string
• null

string

itemIdItemidrequired

serviceIdServiceidrequired

ItemLookupRow

{
  "error": "service_not_found",
  "found": true,
  "item": {
    "amountIsQuantity": false,
    "currency": "string",
    "id": "string",
    "inStock": 0,
    "isLongOrder": true,
    "maxQuantity": 0,
    "minQtyToLongOrder": 0,
    "minQuantity": 0,
    "name": "string",
    "price": 0,
    "stepQuantity": 0,
    "unitPrice": "string"
  },
  "itemId": "string",
  "serviceId": "string"
}