Skip to main content
GET
/
api
/
v1
/
analytics
/
lead
/
overall-stats
curl "https://server.smartlead.ai/api/v1/analytics/lead/overall-stats?api_key=YOUR_KEY&start_date=2024-01-01&end_date=2024-01-31&timezone=America%2FNew_York"

{
  "ok": true,
  "data": {
    "lead_stats": {
      "count": {
        "total": 1000,
        "new": 600,
        "follow_up": 400
      },
      "percentage": {
        "new": 60,
        "follow_up": 40
      }
    }
  }
}

​
Path Parameters

No path parameters

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
​
start_date
string
required
Start date in YYYY-MM-DD format
​
end_date
string
required
End date in YYYY-MM-DD format
​
timezone
string
Timezone string (e.g. “America/New_York”), optional
​
client_ids
string
Comma-separated client IDs (optional)
​
campaign_ids
string
Comma-separated campaign IDs (optional)

​
Request Body

No request body required
curl "https://server.smartlead.ai/api/v1/analytics/lead/overall-stats?api_key=YOUR_KEY&start_date=2024-01-01&end_date=2024-01-31&timezone=America%2FNew_York"

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key. Check your authentication.
​
404
Not Found
The requested resource (campaign, lead, email account, etc.) does not exist or you don’t have access to it
​
422
Validation Error
Request validation failed. Check parameter types, required fields, and value constraints.
​
429
Rate Limit Exceeded
Too many requests. Please slow down and retry after the rate limit resets.
​
500
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.
​
503
Service Unavailable
API is temporarily unavailable or under maintenance. Please try again later.
{
  "ok": true,
  "data": {
    "lead_stats": {
      "count": {
        "total": 1000,
        "new": 600,
        "follow_up": 400
      },
      "percentage": {
        "new": 60,
        "follow_up": 40
      }
    }
  }
}