Overview

Use this API to retrieve the list of all subscription groups created on the CleverTap dashboard.

Base URL

The following is a sample base URL:

https://<region>.api.clevertap.com/category-groups

For region-specific endpoints, refer to Region.

HTTP Method

GET

Headers

Refer to Headers for more details.

Example Request

The following is a sample request to the Get Subscription Groups API, showing the headers needed to authenticate the request.

curl -X GET "https://<region>.api.clevertap.com/category-groups" \
-H "X-CleverTap-Account-Id: ACCOUNT_ID" \
-H "X-CleverTap-Passcode: PASSCODE"

Example Response

The following is a sample response.

{
    "status": "success",
    "list": [
        {
            "name": "Newsletter",
            "key": 1,
            "description": "Newsletter",
            "channels": [
                "Email"
            ],
            "updated_on": 1597812749,
            "created_on": 1597812749
        },
        {
            "name": "Product Updates",
            "key": 2,
            "description": "Product Updates",
            "channels": [
                "Email"
            ],
            "updated_on": 1597826038,
            "created_on": 1597826038
        }
    ]
}

The following table describes the response fields returned inside each object in the list array.

Errors

To know about the errors applicable to this API, refer to API Error Cases. To understand the common queries and concerns related to CleverTap APIs, refer to API FAQs.