Get a currently applicable coupon

Request: No body. Path code (case-insensitive)

Same scoping as the list endpoint - 404 if the code doesn't exist, is inactive/expired, or is target_user_emails-restricted to a different user.

Success: 200 - coupon detail

Errors: 401 - not authenticated | 404 - coupon not found or not applicable to you

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "code": "FIRSTPLAN20",
        "description": "20% off your first Sage or Guru \n    subscription (capped at Rs 200), locked in for renewals",
        "campaign_tag": "first_purchase_plan",
        "discount_type": "percent",
        "discount_value": 20,
        "max_discount_amount": 200,
        "first_purchase_only": true,
        "applicable_slugs": [
            "sage-monthly",
            "sage-quarterly",
            "sage-half-yearly",
            "sage-yearly",
            "guru-monthly",
            "guru-quarterly",
            "guru-half-yearly",
            "guru-yearly"
        ],
        "sticky_for_renewal": true,
        "max_redemptions_per_user": 1,
        "valid_from": 1752739200000,
        "valid_till": 1760688000000,
        "is_active": true
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠406

🟠422Parameter Error

🟠429

Get a currently applicable coupon

Request

Request Code Samples

Responses