curl --request POST \
--url https://api-{dc}.moengage.com/v1/coupon-list/{coupon_list_id}/usage-report \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'MOE-APPKEY: <moe-appkey>' \
--data '
{
"start_date": "2023-12-25",
"end_date": "2023-12-25",
"email_subscribers": [
"[email protected]"
]
}
'{
"message": "The usage report for the {{coupon list name}} coupons is being processed and will be sent to email alert subscribers shortly."
}Generate Usage Report
This API produces a detailed usage report for a specific coupon list, providing details on which user received which coupon from which locale or variation of which campaign at what time. After it is generated, this report is delivered directly to the requested email addresses. Using this API, you can conduct a comprehensive analysis of critical data and coupon usage trends efficiently.
curl --request POST \
--url https://api-{dc}.moengage.com/v1/coupon-list/{coupon_list_id}/usage-report \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'MOE-APPKEY: <moe-appkey>' \
--data '
{
"start_date": "2023-12-25",
"end_date": "2023-12-25",
"email_subscribers": [
"[email protected]"
]
}
'{
"message": "The usage report for the {{coupon list name}} coupons is being processed and will be sent to email alert subscribers shortly."
}Rate Limit
You can generate:- 5 usage reports of coupon list per minute or
- 50 usage reports of coupon list per day
承認
Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.
- Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
- Password: Use your API Key, which you can find within the Campaign report/Business events/Custom templates/Catalog API/Inform Report tile.
For more information on authentication and getting your credentials, refer here.
ヘッダー
This is the Workspace ID of your MoEngage account that must be passed with the request. You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
パスパラメータ
The unique identifier for the coupon list.
ボディ
This field consists of the start date of the coupon list usage report in yyyy-mm-dd format.
This field consists of the end date of the coupon list usage report in yyyy-mm-dd format.
This field consists of the email address of the coupon list subscribers who will receive the report.
レスポンス
Success Indicates that the request is successful and the coupon list usage report request is accepted.
The following is the success message indicating the report is being processed.