Skip to main content
GET
/
api
/
v1
/
subscribers
{
  "success": true,
  "subscribers": [
    {
      "id": "sub_abc123",
      "email": "[email protected]",
      "firstName": "John",
      "lastName": "Doe",
      "status": "active",
      "tags": ["customer", "newsletter"],
      "customAttributes": { "plan": "pro" },
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}
List all subscribers with optional filtering by status or email.

​
Query Parameters

​
page
number
default:"1"
Page number
​
limit
number
default:"20"
Items per page (max 100)
​
status
string
Filter by status: active or unsubscribed
​
email
string
Filter by email (partial match)
curl "https://api.sequenzy.com/api/v1/subscribers?page=1&limit=20&status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Responses

{
  "success": true,
  "subscribers": [
    {
      "id": "sub_abc123",
      "email": "[email protected]",
      "firstName": "John",
      "lastName": "Doe",
      "status": "active",
      "tags": ["customer", "newsletter"],
      "customAttributes": { "plan": "pro" },
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}