Skip to main content
GET
/
subscribers
List subscribers
curl --request GET \
  --url https://app.letterbucket.com/api/v1/subscribers \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "019756c2-7f3a-7c2e-9b1d-2a4e6f8c0d11",
      "email": "[email protected]",
      "name": "John Doe",
      "status": "active",
      "created_at": "2026-06-11T17:00:00+00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 320,
    "pages": 7
  }
}
Invalid status values return 400 Bad Request with a descriptive message.

Authorizations

​
Authorization
string
header
required

Your API key, sent as Authorization: Bearer sk_....

Query Parameters

​
page
integer
default:1

Page number (1-based).

Required range: x >= 1
​
limit
integer
default:50

Items per page. Maximum 100.

Required range: 1 <= x <= 100
​
status
enum<string>

Filter by subscriber status.

Available options:
active,
pending,
unsubscribed

Response

A paginated list of subscribers.

​
success
boolean
​
data
object[]
​
pagination
object