# GET /v1/quality/ivt

Get IVT report

Daily IVT totals and filtering reasons for this publisher, by zone and fixed EST date (UTC-5), up to 92 days inclusive. Requires `publisher:read`. Rate limit tier: `read`.

- Required scope: `publisher:read`
- Rate limit: `read` — 120 requests per 60-second window per API key or web session

## Parameters

| Name | In | Type | Required |
|---|---|---|---|
| `from` | query | string | yes |
| `to` | query | string | yes |
| `zone_id` | query | integer | no |

## Response

```
{ rows: { by_reason: object; capped: integer; date: string; demand_as_of: string | null; demand_ivt_amount: string | null; filtered: integer; final: boolean; ivt_rate_pre: number | null; level: "ok" | "watch" | "strict" | "limited" | "paused_quality"; paused: integer; requests: integer; sent: integer; zone_id: integer }[] }
```

## Errors

Rate-limited routes return `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window ends); a 429 also carries `Retry-After`. The headers may be absent while the limiter is temporarily unavailable (requests are then let through).

| Status | Meaning |
|---|---|
| 401 | Missing, invalid or revoked API key. |
| 403 | The key lacks the required scope, or the operation is not allowed for this actor. |
| 429 | Rate limit exceeded; wait `Retry-After` seconds. |
| 400 | Default Response |
| 404 | Default Response |

HTML documentation: https://agimone.com/en/developers/api/#get-ivt-report
API 2026-10
