---
title: "Get total usage"
method: POST
path: "/usage/total"
tags: ["Analytics"]
---

# Get total usage

`POST /usage/total`

## Request

- Base URL: `https://api.us-east-1.langdb.ai`
- URL: `https://api.us-east-1.langdb.ai/usage/total`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/langdb/apis/ai-gateway-api/docs/usage/total/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `X-Project-Id` string, required

## Request body

- object
  - `start_time_us` integer
  - `end_time_us` integer

## Response `200`

OK

- TotalUsageResponse
  - `models` object[], required
    - `provider` string
    - `model_name` string
    - `total_input_tokens` integer
    - `total_output_tokens` integer
    - `total_cost` number, float
    - `cost_per_input_token` number, float
    - `cost_per_output_token` number, float
  - `total` object, required
    - `total_input_tokens` integer
    - `total_output_tokens` integer
    - `total_cost` number, float
  - `period_start` integer, required
  - `period_end` integer, required

---

[API](https://skmtc.dev/langdb/apis/ai-gateway-api.md) - [All operations](https://skmtc.dev/langdb/apis/ai-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdb/apis/ai-gateway-api/revisions/56b3696d655b?raw)