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

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

## Other responses

- `422` — Validation Error

## Changes

- **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
- **2026-09-18** `082b5fabd909` — 14 info
  - api tag `Policies` added
  - api tag `guardrails` removed
  - added the optional property `chart/items/score` to the response with the `200` status
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - …10 more
- **2026-09-17** `e2f308355e2d` — 2 info
  - api tag `guardrails` added
  - api tag `Policies` removed
- **2026-09-01** `89805a9f84ad` — 2 info
  - api tag `Policies` added
  - api tag `guardrails` 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/731afbea6a1b?raw)