# GET /subscribers/stats — Get Subscriber Statistics

> Product: **Pabbly Email Marketing** (v2)
> Base URL: `https://emails.pabbly.com/api/v2`
> Auth: Bearer via `Authorization` header
> Canonical: `/email-marketing/subscribers/get-subscriber-statistics`

Retrieves subscriber statistics for your business, including total subscriber count and status-wise breakdown (subscribed, unsubscribed, bounced, complaint).

**Response (200)** — Get Subscriber Statistics:

```json
{
    "success": true,
    "status": "success",
    "message": "Subscribers record retrieved successfully",
    "data": {
        "totalSubscribersInBusiness": 1,
        "totalSubscribersAcrossAllLists": 1,
        "listWiseCounts": [
            {
                "_id": "1022247",
                "listName": "Default List",
                "count": 0,
                "totalSubscribers": 0,
                "unsubscribedCount": 0,
                "engagedCount": 0
            },
            {
                "_id": "1024200",
                "listName": "Segment_10 number",
                "count": 0,
                "totalSubscribers": 0,
                "unsubscribedCount": 0,
                "engagedCount": 0
            },
            {
                "_id": "693a5a165ed8605a12f04d10",
                "listName": "Temp List",
                "count": 1,
                "totalSubscribers": 1,
                "unsubscribedCount": 0,
                "engagedCount": 0
            }
        ],
        "leadScoreAnalytics": {
            "averageLeadScore": 90,
            "hotLeads": 1,
            "coldLeads": 0
        },
        "leadScoreConfig": {
            "emailOpen": {
                "value": 5,
                "status": "active"
            },
            "emailClick": {
                "value": 10,
                "status": "active"
            },
            "emailBounce": {
                "value": -20,
                "status": "active"
            },
            "unsubscribe": {
                "value": -50,
                "status": "active"
            },
            "createdAt": "2025-12-16T20:32:02.930Z",
            "updatedAt": "2025-12-16T20:32:02.930Z"
        },
        "statusAnalytics": {
            "subscribed": 1,
            "unsubscribed": 0,
            "bounced": 0,
            "spam": 0
        },
        "engagedSubscribers": 0,
        "isListSpecific": false,
        "selectedListName": "All Subscribers"
    }
}
```

**Code examples:**

_cURL_

```curl
curl https://emails.pabbly.com/api/v2/subscribers/stats \
  -H "Authorization: Bearer {{YOUR_API_KEY}}"
```

_Ruby_

```ruby
require 'net/http'
require 'json'

uri = URI('https://emails.pabbly.com/api/v2/subscribers/stats')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer {{YOUR_API_KEY}}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

data = JSON.parse(response.body)
```

_Python_

```python
import requests

response = requests.get(
    'https://emails.pabbly.com/api/v2/subscribers/stats',
    headers={'Authorization': 'Bearer {{YOUR_API_KEY}}'},
)

data = response.json()
```

_PHP_

```php
<?php
$ch = curl_init('https://emails.pabbly.com/api/v2/subscribers/stats');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer {{YOUR_API_KEY}}']);

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
```

_Java_

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://emails.pabbly.com/api/v2/subscribers/stats"))
    .header("Authorization", "Bearer {{YOUR_API_KEY}}")
    .GET();

HttpRequest request = builder.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

_Node.js_

```node
const response = await fetch('https://emails.pabbly.com/api/v2/subscribers/stats', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{YOUR_API_KEY}}',
  },
});

const data = await response.json();
```

_Go_

```go
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://emails.pabbly.com/api/v2/subscribers/stats", nil)
    req.Header.Set("Authorization", "Bearer {{YOUR_API_KEY}}")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
```

_.NET_

```dotnet
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://emails.pabbly.com/api/v2/subscribers/stats");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer {{YOUR_API_KEY}}");

var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);
```

---

**Other endpoints in Subscribers:**

- [POST /subscribers — Create Subscriber](/email-marketing/subscribers/create-subscriber)
- [GET /subscribers — Get All Subscribers](/email-marketing/subscribers/get-all-subscribers)
- [GET /subscribers/{subscriber ID} — Get Subscriber by ID](/email-marketing/subscribers/get-subscriber-by-id)
- [PUT /subscribers/{ subscriber Id} — Update Subscriber by ID](/email-marketing/subscribers/update-subscriber-by-id)
- [DELETE /subscribers — Delete Subscriber](/email-marketing/subscribers/delete-subscriber)
- [PUT /subscribers/{{email}} — Update Subscriber by Email](/email-marketing/subscribers/update-subscriber-by-email)
- [GET /subscribers/{{email}} — Get Subscriber by Email](/email-marketing/subscribers/get-subscriber-by-email)
- [GET /custom-fields — Get All Custom Fields](/email-marketing/subscribers/get-all-custom-fields)