Fetch All Coupon Lists

This API serves all created coupon lists in a specific workspace. By default, this API returns the coupon lists marked with an ACTIVE status. In return, it offers detailed specifications of the active coupon lists, respective configurations, statuses, expiry dates, and alert conditions, including on-time data on the total coupons added and those that are currently available. This ensures efficient management and accessibility of up-to-date coupon list information.

GET /coupon-list

Fetch All Coupon Lists

cURL

curl --request GET \
  --url https://api-0{dc}.moengage.com/v1/coupon-list \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'MOE-APPKEY: <moe-appkey>'

200

{
  "data": [
    {
      "name": "<string>",
      "label": "<string>",
      "expires_at": "<string>",
      "status": "<string>",
      "total_coupons": 123,
      "created_at": "<string>",
      "updated_at": "<string>",
      "email_alert_subscribers": "<string>",
      "alert_conditions": {},
      "available_coupons": 123,
      "personalization_snippet": "<string>",
      "created_by": "<string>",
      "_id": "<string>"
    }
  ]
}

Information

There is no request body or content to send for this request except for the headers and parameters.

Rate Limit

You can fetch 10,000 coupon lists per day.

Authorizations

Authorization · string · header · required

Uses Workspace ID as username and API Key as password.

Headers

MOE-APPKEY · string · required

This is the workspace ID (earlier APP ID) of your MoEngage workspace. The MOE-APPKEY has to be passed in the request. You can find your MoEngage Workspace ID in the MoEngage Dashboard: Settings -> Account -> APIs -> Workspace ID (earlier app id).

Query Parameters

status · enum<string>

This field contains an array of all the coupons with their respective attributes based on the following statuses you provide in the request parameter:

• ACTIVE - to view only active coupon lists
• ARCHIVED - to view only archived coupon lists
• EXPIRED - to view only expired coupon lists

Note: Not specifying any status will display all the existing coupon lists together.

Available options: ACTIVE, ARCHIVED, EXPIRED

Response

200

application/json

Success Indicates that the request is successful and all the active and/or archived coupon lists are fetched.

data · object[]

Show child attributes