logo
SubscribersList Subscribers

List Subscribers

Retrieve a paginated list of subscribers

curl -X GET "https://app.nashra.ai/api/v1/subscribers?per_page=25&page=25&search=example_string&status=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "uuid": "9a3c2b6e-8f3a-4f7c-b1a4-1f1d5d9e4c22",
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "status": "subscribed",
      "tags": [
        {
          "uuid": "7b2d4c1e-3f5a-4e8d-9c6b-2a1f3e5d7c9b",
          "name": "VIP",
          "color": "#ff5733",
          "created_at": "2025-01-15T10:30:00+00:00"
        }
      ],
      "extra_attributes": {
        "country": "Netherlands",
        "plan": "pro"
      },
      "notes": "Signed up from landing page",
      "created_at": "2025-01-15T10:30:00+00:00",
      "updated_at": "2025-01-15T10:30:00+00:00"
    }
  ],
  "meta": {}
}
GET
/subscribers
GET
Bearer Token
Bearer Tokenstring
Required

API token generated in Settings > API Tokens

API token generated in Settings > API Tokens
query
per_pageinteger

Number of results per page (max 100)

Max: 100
query
pageinteger

Page number

query
statusstring

Filter by subscription status

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. API token generated in Settings > API Tokens

Query Parameters

per_pageinteger

Number of results per page (max 100)

pageinteger

Page number

statusstring

Filter by subscription status

Responses

dataarray
metaobject