Email Lists

Retrieve paginated mailing lists configured inside your customer account.
GET /lists

Retrieves a paginated list of all mailing/subscriber lists belonging to the authenticated customer.

Query Parameters

Parameter Type Status Description
per_page Integer Optional Number of records to return per page (Default: 15, Max: 100).
page Integer Optional The page number of results to fetch (Default: 1).

cURL Example

curl -X GET "https://api.hotsol.net/api/v1/lists?per_page=2" \
     -H "Authorization: Bearer hk_sec_your_secret_key_here" \
     -H "Accept: application/json"

Response Example

{
    "success": true,
    "message": "Lists retrieved successfully.",
    "data": [
        {
            "id": 1,
            "uuid": "4c8f9db0-4fdc-4a3b-9a84-18a72b64d1f2",
            "name": "Weekly Newsletter",
            "from_email": "newsletter@domain.com",
            "from_name": "My Business",
            "reply_to": "support@domain.com",
            "description": "Subscribers for the general newsletter.",
            "status": "active",
            "total_subscriber": 1042,
            "created_at": "2026-08-15T12:00:00.000000Z",
            "updated_at": "2026-08-22T08:00:00.000000Z"
        },
        {
            "id": 2,
            "uuid": "1bc789df-2dfc-4d3b-8a14-23a74b68e9f5",
            "name": "VIP Customers",
            "from_email": "ceo@domain.com",
            "from_name": "VIP News",
            "reply_to": "ceo@domain.com",
            "description": "High-value customers.",
            "status": "active",
            "total_subscriber": 138,
            "created_at": "2026-08-20T14:30:00.000000Z",
            "updated_at": "2026-08-22T09:15:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 5,
        "per_page": 2,
        "total": 10
    }
}