Lead Statistics

Get aggregated statistics and counts for all your leads.

Endpoint

GET /v1/leads/stats

Authentication

Requires API Key via X-API-Key header.

Request

curl -X GET https://api.status-check.io/v1/leads/stats \
  -H "X-API-Key: sk_your_api_key"

Response

{
  "total": 1250,
  "active": 1180,
  "archived": 70,
  "newLeads": 45,
  "validatingLeads": 12,
  "verifiedLeads": 890,
  "warningLeads": 156,
  "riskyLeads": 77,
  "errorLeads": 0,
  "validEmails": 945,
  "invalidEmails": 235,
  "uncheckedEmails": 70,
  "domainStatusOk": 1021,
  "averageDeliverabilityRating": 82.5
}

Response Fields

Overview Counts

Field	Type	Description
total	integer	Total number of leads in your account (active + archived)
active	integer	Number of active leads (not archived)
archived	integer	Number of archived/deleted leads

Validation Status Counts

Leads are categorized by their validation status. These counts help you understand the quality distribution of your leads.

Field	Type	Description
newLeads	integer	Leads that haven't been validated yet. They're waiting for validation to start.
validatingLeads	integer	Leads currently being validated. The validation process is in progress.
verifiedLeads	integer	High quality - Leads that passed all validation checks. Domain is active, email is deliverable. Safe to contact.
warningLeads	integer	Medium quality - Leads with minor issues (e.g., slow domain response, catch-all email). Use with caution.
riskyLeads	integer	Low quality - Leads with technical problems (e.g., domain errors, undeliverable email). Avoid contacting.
errorLeads	integer	Leads where validation failed due to system errors. May need re-validation.

Legacy Email Metrics (Deprecated)

These fields are maintained for backwards compatibility but are deprecated. Use validation status counts instead.

Field	Type	Description
validEmails	integer	⚠️ Deprecated - Count of leads with deliverable emails
invalidEmails	integer	⚠️ Deprecated - Count of leads with undeliverable emails
uncheckedEmails	integer	⚠️ Deprecated - Count of leads with unvalidated emails
domainStatusOk	integer	⚠️ Deprecated - Count of leads with active domains

Quality Metrics

Field	Type	Description
averageDeliverabilityRating	float	Average email deliverability score across all validated leads. Range: 0-100. Higher is better.

Use Cases

Monitor lead quality:

const stats = await getLeadStats();
const qualityRatio = stats.verifiedLeads / stats.total;
console.log(`${(qualityRatio * 100).toFixed(1)}% of your leads are high quality`);

Check validation progress:

if (stats.validatingLeads > 0) {
  console.log(`${stats.validatingLeads} leads are being validated...`);
}

Alert on low quality:

if (stats.averageDeliverabilityRating < 60) {
  console.warn('Your leads have low deliverability. Consider better sources.');
}

Rate Limits

• 60 requests per minute
• 1,000 requests per hour

Errors

Status Code	Error	Description
401	Unauthorized	Missing or invalid API key
500	Internal Server Error	Failed to fetch statistics