Skip to main content
GET
/
api
/
subscribers
List Subscribers
curl --request GET \
  --url https://api.example.com/api/subscribers
{
  "subscribers": [
    {
      "id": "<string>",
      "email": "<string>",
      "verified": true,
      "createdAt": "<string>"
    }
  ],
  "total": 123
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/subratomandal/dyeink/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

This endpoint requires authentication. Include a valid session cookie or authentication token.

​
Response

Returns a list of all active subscribers for the authenticated user’s blog.
​
subscribers
array
required
Array of subscriber objects
​
id
string
required
Unique identifier for the subscriber
​
email
string
required
Email address of the subscriber
​
verified
boolean
required
Whether the subscriber’s email has been verified
​
createdAt
string
required
Timestamp when the subscription was created (ISO 8601 format)
​
total
number
required
Total count of active subscribers

​
Example Request

cURL
curl -X GET https://api.dyeink.com/api/subscribers \
  -H "Cookie: session=your-session-token"

​
Example Response

{
  "subscribers": [
    {
      "id": "507f1f77bcf86cd799439011",
      "email": "[email protected]",
      "verified": true,
      "createdAt": "2026-03-01T10:30:00.000Z"
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "email": "[email protected]",
      "verified": false,
      "createdAt": "2026-03-03T14:22:00.000Z"
    }
  ],
  "total": 2
}

​
Error Responses

​
401 Unauthorized
User is not authenticated
{
  "error": "Not authenticated"
}
​
500 Internal Server Error
Failed to retrieve subscribers
{
  "error": "Failed to get subscribers"
}

​
Notes

  • Only returns active subscribers (subscribers who haven’t unsubscribed)
  • Subscribers are sorted by creation date, with newest first
  • If the user has no blog settings, returns an empty array with total of 0