> ## 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.

# Metrics

> Reference documentation for metrics.

## 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:

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

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