Tamio

Retrieve a discount

GET https://api.tamio.com/v2/discounts/retrieve/{uuid}

Retrieves a single discount by UUID including all configuration details, associated products, categories, coupon/voucher information, and subscription settings.

Path Parameters

uuid string*

Responses

200 Discount retrieved successfully

Discount retrieved successfully

status integer
discount Discount
400 Validation or business-logic error.
401 Unauthorized – invalid or missing Bearer token
/discounts/retrieve/{uuid}
1const response = await fetch("https://api.tamio.com/v2/discounts/retrieve/{uuid}", {
2 headers: {
3 "Authorization": "Bearer YOUR_API_KEY",
4 "Accept": "application/json"
5 }
6});
7const data = await response.json();
Responses
{
  "status": 200,
  "discount": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "discount",
    "label": "Summer Sale 10% Off",
    "currency": "EUR",
    "percent_off": 10,
    "amount_off": 0,
    "shipping_percent_off": 0,
    "shipping_amount_off": 0,
    "active": true,
    "type": "product_discount",
    "condition": "coupon",
    "applies_to": "all_products",
    "rule_amount": 5000,
    "order_condition": "order_subtotal",
    "block_affiliates": false,
    "destinations": [
      "worldwide"
    ],
    "payments": [
      "all"
    ],
    "expiry_date": 1735689600,
    "subscription_discount_duration": "once",
    "number_of_months": 3,
    "domain": 12,
    "customer": "660e8400-e29b-41d4-a716-446655440001",
    "products": [
      "770e8400-e29b-41d4-a716-446655440002"
    ],
    "categories": {
      "physical": [
        "clothing",
        "accessories"
      ],
      "digital": [],
      "services": [],
      "billing_plans": []
    },
    "coupon": "SUMMER10",
    "coupon_max_redemptions": 100,
    "coupon_times_redeemed": 45,
    "vouchers": [],
    "voucher_method": "autogenerated",
    "voucher_prefix": "SALE_",
    "number_of_vouchers": 100,
    "created_at": 1700000000
  }
}