---
title: "Get Global Spend Report"
method: GET
path: "/global/spend/report"
tags: ["Budget & Spend Tracking"]
---

# Get Global Spend Report

`GET /global/spend/report`

Get Daily Spend per Team, based on specific startTime and endTime. Per team, view usage by each key, model
[
    {
        "group-by-day": "2024-05-10",
        "teams": [
            {
                "team_name": "team-1"
                "spend": 10,
                "keys": [
                    "key": "1213",
                    "usage": {
                        "model-1": {
                                "cost": 12.50,
                                "input_tokens": 1000,
                                "output_tokens": 5000,
                                "requests": 100
                            },
                            "audio-modelname1": {
                            "cost": 25.50,
                            "seconds": 25,
                            "requests": 50
                    },
                    }
                }
        ]
    ]
}

## Query parameters

- `start_date` string, nullable — Time from which to start viewing spend
- `end_date` string, nullable — Time till which to view spend
- `group_by` 'team' | 'customer' | 'api_key', nullable — Group spend by internal team or customer or api_key
- `api_key` string, nullable — View spend for a specific api_key. Example api_key='sk-1234
- `internal_user_id` string, nullable — View spend for a specific internal_user_id. Example internal_user_id='1234
- `team_id` string, nullable — View spend for a specific team_id. Example team_id='1234
- `customer_id` string, nullable — View spend for a specific customer_id. Example customer_id='1234. Can be used in conjunction with team_id as well.

## Response `200`

Successful Response

- LiteLLMSpendLogsOutput[]
  - `request_id` string, required
  - `api_key` string, required
  - `model` string, nullable
  - `api_base` string, nullable
  - `call_type` string, required
  - `spend` number, nullable
  - `total_tokens` integer, nullable
  - `prompt_tokens` integer, nullable
  - `completion_tokens` integer, nullable
  - `startTime` union, required
    - string
    - string, date-time
  - `endTime` union, required
    - string
    - string, date-time
  - `user` string, nullable
  - `metadata` unknown
  - `cache_hit` string, nullable
  - `cache_key` string, nullable
  - `request_tags` unknown
  - `requester_ip_address` string, nullable
  - `messages` union, required
    - string
    - unknown[]
      - unknown
    - object
  - `response` union, required
    - string
    - unknown[]
      - unknown
    - object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)
