Skip to main content
GET
https://api.mailgreet.com
/
api
/
v1
/
external
/
subscribers
/
stats
curl -X GET "https://api.mailgreet.com/api/v1/external/subscribers/stats" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "total": 1500,
    "active": 1350,
    "unsubscribed": 100,
    "bounced": 50,
    "limit": 5000,
    "usage_percentage": 30
  }
}

​
Overview

Retrieve aggregate statistics about your subscriber base including counts by status and plan usage information.

​
Authentication

​
Authorization
string
required
Bearer token. Format: Bearer YOUR_API_KEY

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl -X GET "https://api.mailgreet.com/api/v1/external/subscribers/stats" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "total": 1500,
    "active": 1350,
    "unsubscribed": 100,
    "bounced": 50,
    "limit": 5000,
    "usage_percentage": 30
  }
}

​
Use Cases

Dashboard Widgets

Display subscriber metrics in your application dashboard

Limit Monitoring

Monitor usage to avoid hitting subscriber limits

Health Checks

Track bounce rates and subscriber health

Reporting

Generate subscriber growth reports