List Coupons Endpoint

GET

/admin/coupons

List all coupons with filters (Admin only)

Query parameters:

scope: Filter by coupon_scope (user_specific or global)

coupon_type: Filter by type

is_active: Filter by active status

limit: Max results (default 100)

offset: Pagination offset

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/admin/coupons?scope&coupon_type&is_active&limit&offset' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "coupons": [
        {
            "id": 0,
            "code": "string",
            "value_usd": 0,
            "coupon_scope": "string",
            "coupon_type": "string",
            "max_uses": 0,
            "times_used": 0,
            "valid_from": "2019-08-24T14:15:22Z",
            "valid_until": "2019-08-24T14:15:22Z",
            "is_active": true,
            "created_at": "2019-08-24T14:15:22Z",
            "assigned_to_user_id": 0,
            "created_by": 0,
            "created_by_type": "string",
            "description": "string"
        }
    ],
    "total": 0,
    "offset": 0,
    "limit": 0
}

Modified at 2025-10-27 16:08:17

Create Coupon Endpoint

Get Coupon Endpoint