Get all subscribers

GET

/api/subscribers

Retrieve all subscribers for the authenticated user

Request

Authorization

Query Params

Responses

🟢200OK

application/json

Subscribers retrieved successfully

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.maildesk.io/api/subscribers?limit=undefined&page=undefined'

Response Example

{
    "subscribers": [
        {
            "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
            "email": "john.doe@example.com",
            "firstName": "John",
            "lastName": "Doe",
            "status": "CONFIRMED",
            "tags": [
                "Newsletter",
                "Premium"
            ],
            "createdAt": "2024-03-20T10:00:00.000Z"
        }
    ],
    "total": 100,
    "page": 1,
    "limit": 10
}

Modified at 2026-04-21 06:01:17

Delete a subscriber

Create a new subscriber