Get Offering
curl --request GET \
--url https://api-{dc}.moengage.com/v5/offers/{offer_id} \
--header 'Authorization: Basic <encoded-value>'{
"type": "offer",
"data": {
"status": "scheduled",
"created_at": "2026-08-07T23:42:21.556936210Z",
"updated_at": "2026-08-07T23:42:21.556979662Z",
"updated_by": "[email protected]",
"created_by": "[email protected]",
"name": "personalized_offer",
"description": "Configured using personalization template",
"priority": 90,
"scheduling": {
"start_datetime": "2026-08-08T00:23:00Z",
"expiry_datetime": "2027-08-07T23:23:00Z",
"timezone": "Asia/Kolkata"
},
"segment_info": {
"filters": {
"included_filters": {
"filter_operator": "and",
"filters": [
{
"action_name": "MOE_PAGE_VIEWED",
"executed": true,
"filter_type": "actions",
"execution": {
"count": 1,
"type": "atleast"
},
"primary_time_range": {
"type": "inTheLast",
"value": 2,
"value_type": "relative_past",
"period_unit": "weeks"
},
"attributes": {
"filter_operator": "and",
"filters": []
}
}
]
}
}
},
"variation_meta": {
"type": "SMV",
"control_group": {
"is_enabled": false,
"percentage": 0
},
"smv_distribution": {
"split": {
"1": 100
}
}
},
"capping_rules": {
"overall": {
"enabled": false,
"limit_value": 1,
"limit_schedule": "DAILY"
},
"user_level": {
"enabled": false,
"limit_value": 1,
"limit_schedule": "DAILY"
}
},
"is_global_control_enabled": true
}
}"{\"code\":\"ER001\",\"target\":\"Authentication Invalid\",\"message\":\"Auth validation failed.\"}"{
"response_id": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
"target": "<string>",
"details": [
{
"code": "<string>",
"target": "<string>",
"message": "<string>"
}
]
}
}{
"response_id": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
"target": "<string>",
"details": [
{
"code": "<string>",
"target": "<string>",
"message": "<string>"
}
]
}
}{
"response_id": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
"target": "<string>",
"details": [
{
"code": "<string>",
"target": "<string>",
"message": "<string>"
}
]
}
}"<html><body><h1>503 Service Temporarily Unavailable</h1></body></html>"Get Offering
Retrieve the full configuration of a single offering by its ID.
GET
/
v5
/
offers
/
{offer_id}
Get Offering
curl --request GET \
--url https://api-{dc}.moengage.com/v5/offers/{offer_id} \
--header 'Authorization: Basic <encoded-value>'{
"type": "offer",
"data": {
"status": "scheduled",
"created_at": "2026-08-07T23:42:21.556936210Z",
"updated_at": "2026-08-07T23:42:21.556979662Z",
"updated_by": "[email protected]",
"created_by": "[email protected]",
"name": "personalized_offer",
"description": "Configured using personalization template",
"priority": 90,
"scheduling": {
"start_datetime": "2026-08-08T00:23:00Z",
"expiry_datetime": "2027-08-07T23:23:00Z",
"timezone": "Asia/Kolkata"
},
"segment_info": {
"filters": {
"included_filters": {
"filter_operator": "and",
"filters": [
{
"action_name": "MOE_PAGE_VIEWED",
"executed": true,
"filter_type": "actions",
"execution": {
"count": 1,
"type": "atleast"
},
"primary_time_range": {
"type": "inTheLast",
"value": 2,
"value_type": "relative_past",
"period_unit": "weeks"
},
"attributes": {
"filter_operator": "and",
"filters": []
}
}
]
}
}
},
"variation_meta": {
"type": "SMV",
"control_group": {
"is_enabled": false,
"percentage": 0
},
"smv_distribution": {
"split": {
"1": 100
}
}
},
"capping_rules": {
"overall": {
"enabled": false,
"limit_value": 1,
"limit_schedule": "DAILY"
},
"user_level": {
"enabled": false,
"limit_value": 1,
"limit_schedule": "DAILY"
}
},
"is_global_control_enabled": true
}
}"{\"code\":\"ER001\",\"target\":\"Authentication Invalid\",\"message\":\"Auth validation failed.\"}"{
"response_id": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
"target": "<string>",
"details": [
{
"code": "<string>",
"target": "<string>",
"message": "<string>"
}
]
}
}{
"response_id": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
"target": "<string>",
"details": [
{
"code": "<string>",
"target": "<string>",
"message": "<string>"
}
]
}
}{
"response_id": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
"target": "<string>",
"details": [
{
"code": "<string>",
"target": "<string>",
"message": "<string>"
}
]
}
}"<html><body><h1>503 Service Temporarily Unavailable</h1></body></html>"Rate Limit
The rate limit is 150 requests per minute, 500 requests per hour, and 1000 requests per day.Authorizations
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). Find it in the MoEngage dashboard at Settings > Account > API keys.
- Password: Use an API key from Settings > Account > API keys.
Refer to API Key Dashboard for details on creating and managing API keys.
Path Parameters
Must include the offer_ prefix (e.g. offer_6a4f69ee490f66322f968b87). You can retrieve the prefixed ID from the data[].id field in the List Offerings API response.