Skip to main content

ItemLookupResponse

items object[]required
  • Array [
    • error object
    anyOf
    string

    Possible values: [service_not_found, item_not_found, upstream_error]

    foundFoundrequired
    item object
    anyOf
    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
    maxQuantity object

    Maximum allowed quantity. Present only when amountIsQuantity=true.

    anyOf
    integer
    minQtyToLongOrder object

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

    anyOf
    integer
    minQuantity object

    Minimum allowed quantity. Present only when amountIsQuantity=true.

    anyOf
    integer
    name object
    anyOf
    string
    pricePricerequired
    stepQuantity object

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

    anyOf
    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
    itemIdItemidrequired
    serviceIdServiceidrequired
  • ]
    • ItemLookupResponse
    {
      "items": [
        {
          "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"
        }
      ]
    }