Skip to main content
GET

Query Parameters

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

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.

How these metrics are calculated

Shared rules (inclusive date boundaries, unique vs raw counts, rate formulas) are documented once in How Analytics Metrics Are Calculated.
This endpoint returns a daily breakdown where each metric sits on its own event date: Because each metric is anchored to the day its own event occurred, an email sent on one day and the reply it generated on a later day land on different rows. If you want every metric attributed to the send date instead (so opens and replies line up with the day the email went out), use the by sent time variant. All counts here are raw event counts, so they are additive across days. Dates are inclusive on both ends; a single date (start equal to end) returns that one full day.