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
filter
string
Filter value for client results
full_data
string
Set to “true” to return full data set
limit
string
Max number of results to return
offset
string
Pagination offset

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.
One row is returned per client, aggregating every campaign that belongs to that client. All metrics are scoped to emails sent within the date range (sent_time), inclusive on both ends; a single date returns that one full day.