SubscribersList Subscribers

List Subscribers

Retrieve subscribers, newest first, one page at a time. The response carries no totals or page count — keep requesting the next page until you get back fewer than per_page items.

curl -X GET "https://app.nashra.ai/api/v1/subscribers?per_page=15&page=25&search=example_string&status=subscribed" \
  -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": "blue",
          "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
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

API key created in Settings → API keys

API key created in Settings → API keys
query
per_pageinteger

Number of results per page (max 100)

Max: 100
query
pageinteger

Page number

query
statusstring

Filter by subscription status

Options: subscribed, unsubscribed, unconfirmed
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. API key created in Settings → API keys

Query Parameters

per_pageinteger

Number of results per page (max 100)

pageinteger

Page number

statusstring

Filter by subscription status

Allowed values:subscribedunsubscribedunconfirmed

Responses

dataarray
metaobject