Download Campaign Report

Campaign Report API lets you download campaign reports for any specific date range. You can fetch reports for one-time and periodic campaigns.

Important: Successful API requests automatically download the report file.

GET /campaign_reports/rest_api/{APP_ID}/{FILENAME}

Download Campaign Report

cURL

curl --request GET \
  --url https://api-0{dc}.moengage.com/campaign_reports/rest_api/{APP_ID}/{FILENAME} \
  --header 'Signature: <api-key>'

200

"<string>"

Generating the Signature

A unique signature must be passed in the headers to verify the caller’s authenticity.

The signature is SHA256(Api_ID + "|" + FILENAME + "|" + SECRET_KEY).

# SAMPLE IMPLEMENTATION IN PYTHON
from hashlib import sha256
Api_ID = "YOUR-APP-ID"
FILENAME = "Report_-_test_20210217.zip"
SECRET_KEY = "YOUR-SECRET-KEY"
Signature_Key = Api_ID + "|" + FILENAME + "|" + SECRET_KEY
# Now Signature is hexdigest of sha256 of Signature_Key
Signature = sha256(Signature_Key.encode('utf-8')).hexdigest()

Expiry: The generated reports will expire in 7 days from the date of creation.

Max Range: You can generate reports for up to 90 days.

Authorizations

Signature · string · header · required

Custom SHA256 Signature.

Headers

Signature · string · required

A custom signature generated by SHA256(Api_ID + "|" + FILENAME + "|" + SECRET_KEY).

Path Parameters

APP_ID · string · required

Your MoEngage App ID (Workspace ID). Can be fetched from Settings > Account > APIs.

FILENAME · string · required

The name of the report file to download. It is a combination of report name, generation date, and file format. Example: Report_test_20210217.zip

Response

200

application/gzip

Successful API request automatically downloads the report file.

The response is of type file.