Products

Product operations. Products exist in three types:

  • digital - Digital product. Any Telegram message with optional attachments

  • custom - Custom product. On-demand content, e.g., personalized video greetings

  • physical - Physical product. Merchandise with shipping, e.g., printed t-shirts

All amounts are in smallest currency units (cents/kopecks)

Get Products List

get

Returns a paginated list of products

Authorizations
Query parameters
pageinteger · min: 1Optional

Page number

Default: 1
sizeinteger · min: 1 · max: 100Optional

Items per page

Default: 20
typestring · enumOptional

Filter by product type

Possible values:
descbooleanOptional

Sort by ID descending

Default: false
Responses
200

Successful response

application/json
get
GET /api/v1/products HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "rows": [
    {
      "id": 2548,
      "type": "digital",
      "name": "VPN Access - 1 Month",
      "description": "High-speed VPN service with unlimited bandwidth and 50+ server locations worldwide",
      "amount": 499,
      "currency": "usd",
      "starsAmount": 100,
      "starsAmountEnabled": true,
      "status": "approved",
      "isCustom": false,
      "acceptCards": true,
      "acceptWalletPay": false,
      "protectContent": true,
      "created": "2025-08-25T10:30:00Z",
      "updated": "2025-08-25T10:30:00Z",
      "pendingOrders": 3,
      "imageUrl": "https://cdn.example.com/image.jpg",
      "link": "https://t.me/tribute_bot/app?startapp=pf6",
      "webLink": "https://web.tribute.tg/p/f6"
    }
  ],
  "meta": {
    "total": 1,
    "offset": 1,
    "limit": 1
  }
}

Get Product by ID

get

Returns a single product by its ID

Authorizations
Path parameters
idintegerRequired

Product ID

Responses
200

Successful response

application/json
get
GET /api/v1/products/{id} HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "id": 2548,
  "type": "digital",
  "name": "VPN Access - 1 Month",
  "description": "High-speed VPN service with unlimited bandwidth and 50+ server locations worldwide",
  "amount": 499,
  "currency": "usd",
  "starsAmount": 100,
  "starsAmountEnabled": true,
  "status": "approved",
  "isCustom": false,
  "acceptCards": true,
  "acceptWalletPay": false,
  "protectContent": true,
  "created": "2025-08-25T10:30:00Z",
  "updated": "2025-08-25T10:30:00Z",
  "pendingOrders": 3,
  "imageUrl": "https://cdn.example.com/image.jpg",
  "link": "https://t.me/tribute_bot/app?startapp=pf6",
  "webLink": "https://web.tribute.tg/p/f6"
}
PreviousOrdersNextWebhooks