Batch verification series

Overview

Return daily metrics series for a batch verification task over a selected date range.

GET /api/v1/tasks//series

Purpose: daily metrics series for a batch verification task between from and to dates (max 90 days). Query parameters:

from (RFC3339, optional)
to (RFC3339, optional)

Rules:

If both from and to are omitted, last 7 days are returned.
If either is provided, both must be provided.
Max range is 90 days.

Example request:

curl -X GET \
  'https://api.boltroute.ai/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000/series?from=2025-01-01T00:00:00Z&to=2025-01-07T00:00:00Z'

Response

Status: 200 OK Example response:

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "source": "frontend",
  "series": [
    {
      "date": "2025-01-01",
      "total_email_addresses": 2,
      "job_status": {
        "pending": 0,
        "processing": 0,
        "completed": 2,
        "failed": 0
      },
      "progress": 1,
      "progress_percent": 100,
      "verification_status": {
        "valid": 2,
        "invalid": 0,
        "catchall": 0,
        "invalid_syntax": 0,
        "disposable_domain": 0,
        "unknown": 0,
        "role_based": 0,
        "disposable_domain_emails": 0
      },
      "last_verification_requested_at": "2025-01-01T12:00:01Z",
      "last_verification_completed_at": "2025-01-01T12:04:59Z"
    }
  ]
}

Response fields:

task_id: batch verification task UUID.
source: batch verification origin (frontend or api_key).
series: list of daily metrics points.

Errors:

400 invalid ID or date parameters.
401 unauthorized.
403 forbidden.
404 batch verification task not found.
500 internal error.

API documentation

Authorization

Email Verification API

Webhooks

Reporting

Credit

Endpoint examples

Overview

GET /api/v1/tasks//series

Response

​Overview

​GET /api/v1/tasks//series

​Response

Overview

GET /api/v1/tasks//series

Response