---
title: "Get Spend Capture Rate"
method: GET
path: "/spend/capture_rate"
tags: ["Budget & Spend Tracking"]
---

# Get Spend Capture Rate

`GET /spend/capture_rate`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/spend/capture_rate`
- Auth: API key in header `x-litellm-api-key`

Compare the spend LiteLLM captured for a provider against that provider's own bill, per UTC day.

Admin only. Reads the provider's billing API with the billing credential set on the proxy
(OpenAI: `OPENAI_ADMIN_KEY`) and sums `LiteLLM_DailyUserSpend` for the same days.

Example:
```
curl -H "Authorization: Bearer $LITELLM_MASTER_KEY"       "http://localhost:4000/spend/capture_rate?provider=openai&start_date=2026-09-17&end_date=2026-09-23"
```

## Query parameters

- `start_date` string, date, required: First UTC day of the range, YYYY-MM-DD
- `end_date` string, date, required: Last UTC day of the range, YYYY-MM-DD, inclusive
- `provider` 'openai': Provider whose bill to compare against; needs OPENAI_ADMIN_KEY set on the proxy
- `threshold` number: Ratio under which the report flags below_threshold
- `project_ids` string[], nullable: Scope the OpenAI bill to these project ids; omit to compare against the whole organization. Captured spend is never scoped, so pass every project LiteLLM's OpenAI keys belong to

## Response `200`

Successful Response

- CaptureRateReport
  - `provider` 'openai', required
  - `start_date` string, required
  - `end_date` string, required
  - `captured_spend` number, required
  - `provider_spend` number, required
  - `capture_rate` number, nullable, required
  - `threshold` number, required
  - `below_threshold` boolean, required
  - `days` CaptureRateDay[], required
    - `date` string, required
    - `captured_spend` number, required
    - `provider_spend` number, required
    - `capture_rate` number, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/spend/capture_rate/get.md)

---

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