🟢GET lists

Retrieve all lists

GET https://app.referralhero.com/api/v2/lists

Get all the lists/campaigns in your account. Results are paginated (10 results per page). Only active lists will be retrieved.

Path Parameters

Name	Type	Description
api_token	string	Your API Token
page	string	Page you want to jump to. By default 1.

Response

200

{
    "status": "ok",
    "data": {
        "response": "lists_retrieved",
        "lists": [
            {
                "uuid": "MF521c3aade8",
                "name": "My amazing sweepstake",
                "created_at": 1731936007,
                "subscribers": 0
            },
            {
                "uuid": "MF41c1858b40",
                "name": "Shopify",
                "created_at": 1725628341,
                "subscribers": 40
            },
            ...
        ],
        "pagination": {
            "total_pages": 1,
            "current_page": 1,
            "per_page": 10,
            "total_objects": 7
        }
    },
    "calls_left": 1000,
    "timestamp": 1731937134
}