Skip to main content

Overview

Retrieve verification metrics with optional date filtering to summarize volume, status breakdowns, and recent activity. Auth: API key required.

GET /api/v1/metrics/verifications

Purpose: return verification metrics for a user. Query parameters:
  • from (RFC3339, optional): filter metrics from this date
  • to (RFC3339, optional): filter metrics up to this date
Notes:
  • Series data is only included when both from and to are provided.
Example request:
curl -X GET \
  'https://api.boltroute.ai/api/v1/metrics/verifications?from=2025-01-01T00:00:00Z&to=2025-01-07T00:00:00Z'

Response

Status: 200 OK Example response:
{
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "total_verifications": 1234,
  "total_tasks": 12,
  "unique_email_addresses": 1200,
  "job_status": {
    "pending": 0,
    "processing": 0,
    "completed": 1200,
    "failed": 34
  },
  "verification_status": {
    "valid": 900,
    "invalid": 200,
    "catchall": 50,
    "invalid_syntax": 20,
    "disposable_domain": 5,
    "unknown": 59
  },
  "total_catchall": 50,
  "total_role_based": 42,
  "total_disposable_domain_emails": 5,
  "last_verification_requested_at": "2025-01-07T12:00:00Z",
  "last_verification_completed_at": "2025-01-07T12:05:00Z",
  "series": [
    {
      "date": "2025-01-01",
      "total_verifications": 200,
      "total_tasks": 2,
      "unique_email_addresses": 195,
      "job_status": { "pending": 0, "processing": 0, "completed": 200, "failed": 0 },
      "verification_status": { "valid": 150, "invalid": 30, "catchall": 10, "invalid_syntax": 5, "disposable_domain": 1, "unknown": 4 },
      "total_catchall": 10,
      "total_role_based": 5,
      "total_disposable_domain_emails": 1
    }
  ]
}
Errors:
  • 400 invalid date params.
  • 401 unauthorized.
  • 500 internal error.