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"
import requests
import json
url = "https://app.nashra.ai/api/v1/subscribers?per_page=25&page=25&search=example_string&status=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://app.nashra.ai/api/v1/subscribers?per_page=25&page=25&search=example_string&status=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
)
func main() {
req, err := http.NewRequest("GET", "https://app.nashra.ai/api/v1/subscribers?per_page=25&page=25&search=example_string&status=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://app.nashra.ai/api/v1/subscribers?per_page=25&page=25&search=example_string&status=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"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
RequiredAPI 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
searchstring
Search by email, first name, or last name
query
statusstring
Filter by subscription status
Request Preview
Response
Response will appear here after sending the request
Authentication
header
Authorizationstring
RequiredBearer token. API token generated in Settings > API Tokens
Query Parameters
per_pageinteger
Number of results per page (max 100)
pageinteger
Page number
searchstring
Search by email, first name, or last name
statusstring
Filter by subscription status
Responses
dataarray
metaobject
Was this page helpful?
Last updated Mar 2, 2026
Built with Documentation.AI