---
title: "Policies Usage Overview"
method: GET
path: "/policies/usage/overview"
tags: ["guardrails"]
---

# Policies Usage Overview

`GET /policies/usage/overview`

Return policy performance overview for the dashboard.

## Query parameters

- `start_date` string, nullable — YYYY-MM-DD
- `end_date` string, nullable — YYYY-MM-DD

## Response `200`

Successful Response

- UsageOverviewResponse
  - `chart` UsageChartPoint[], required
    - `blocked` integer, required
    - `date` string, required
    - `passed` integer, required
    - `score` number, nullable
  - `passRate` number, required
  - `rows` UsageOverviewRow[], required
    - `avgLatency` number, nullable, required
    - `avgScore` number, nullable, required
    - `cost` number, nullable, required — USD for the priced share of usageUnits over the window; null when no unit was priced
    - `failRate` number, required
    - `id` string, required
    - `name` string, required
    - `provider` string, required
    - `requestsEvaluated` integer, required
    - `status` string, required
    - `trend` string, required
    - `type` string, required
    - `untrackedUsageUnits` object, required — The share of usageUnits that cost leaves out: units recorded with no known price, per counter
    - `usageUnits` object, required
  - `totalBlocked` integer, required
  - `totalCost` number, nullable, required
  - `totalRequests` integer, required
  - `totalUntrackedUsageUnits` object, required
  - `totalUsageUnits` object, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-27** `b694deb1e459` — 2 info
  - api tag `guardrails` added
  - api tag `Policies` removed
- **2026-09-26** `cfac079bcc04` — 2 info
  - api tag `Policies` added
  - api tag `guardrails` removed
- **2026-09-25** `a4fccd4bf54d` — 2 info
  - api tag `guardrails` added
  - api tag `Policies` removed
- **2026-09-21** `6246f8d427b7` — 2 info
  - api tag `Policies` added
  - api tag `guardrails` removed
- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `guardrails` added
  - api tag `Policies` removed

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/policies/usage/overview/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/b694deb1e459?raw)