curl --request GET \
--url https://api-{dc}.moengage.com/v5/subscription-categories \
--header 'Authorization: Basic <encoded-value>' \
--header 'MOE-APPKEY: <moe-appkey>'{
"response_id": "resp_9f1c2a4e7b3d4f8a9c012e5b6d7a8f90",
"type": "subscription_category",
"data": [
{
"name": "promotional",
"display_name": "Promotional",
"description": "Offers and promotions",
"channel": "email",
"group": "Marketing",
"status": "active"
},
{
"name": "newsletter",
"display_name": "Newsletter",
"description": "Monthly newsletter",
"channel": "email",
"group": "Updates",
"status": "active"
}
]
}Get Subscription Categories (V5)
Returns the active subscription-category catalog for the workspace, served from the existing hourly category cache. No user identifier is required.
curl --request GET \
--url https://api-{dc}.moengage.com/v5/subscription-categories \
--header 'Authorization: Basic <encoded-value>' \
--header 'MOE-APPKEY: <moe-appkey>'{
"response_id": "resp_9f1c2a4e7b3d4f8a9c012e5b6d7a8f90",
"type": "subscription_category",
"data": [
{
"name": "promotional",
"display_name": "Promotional",
"description": "Offers and promotions",
"channel": "email",
"group": "Marketing",
"status": "active"
},
{
"name": "newsletter",
"display_name": "Newsletter",
"description": "Monthly newsletter",
"channel": "email",
"group": "Updates",
"status": "active"
}
]
}Rate Limit
The rate limit is 100 RPM and 360k per day.Authorizations
Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.
- Username: Your MoEngage app key.
- Password: Your MoEngage API secret.
Transitional note: This route currently accepts Basic Auth only. Bearer token support (Authorization: Bearer <token>) is planned but not yet active here — Bearer requests return 401 until the APISIX gateway fronts this route.
For more information on authentication and getting your credentials, refer here.
Headers
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).
Client-supplied trace ID for tracing. Correlates with response_id. Supply this header or request_id in the body; if both are set, they must match.
Query Parameters
Optional. Filters the catalog to a single channel. Omit to return categories for all channels. Only the email channel is supported at present.
email