> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boltroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch verification series

> Daily metrics series for a batch verification task.

## Overview

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

## GET /api/v1/tasks/{id}/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:

```bash theme={null}
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:

```json theme={null}
{
  "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.