Admin - get subscribers list

Request: No body - filters passed as query parameters.

Returns paginated newsletter/blog subscribers (role subscribers), separate from the app user list. Admin role required.

Query params (all optional): page_number (default 1), search (matches email).

Success: 200 - data.subscribers[] (each: email, created_at, current_city, current_state, current_lat, current_lng, device_details) plus data.total, data.offset, data.limit. current_* are null for email-only subscribers with no profile.

Errors: 401 - missing/invalid token | 403 - not an admin

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Subscribers fetched successfully",
    "data": {
        "subscribers": [
            {
                "email": "saikat@example.com",
                "current_city": "Kolkata",
                "current_state": "West Bengal",
                "current_lat": 22.5726,
                "current_lng": 88.3639,
                "device_details": "Win32 | Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/149.0.0.0 Safari/537.36 | en-US",
                "created_at": "2026-06-29T18:37:47Z"
            }
        ],
        "total": 1,
        "offset": 0,
        "limit": 20
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error