---
title: "Get Today Usage"
method: GET
path: "/usage/today"
tags: ["usage"]
---

# Get Today Usage

`GET /usage/today`

## Request

- Base URL: `https://api.getmetacognition.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getmetacognition.com/usage/today`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/usage/today/get.ts> (a function with typed inputs; its response is checked against the schema)

Today's usage for the caller's org plus the active daily quota.

The dashboard 'projection' chart is built from this.

## Response `200`

Successful Response

- UsageQuotaStatus
  - `tokens_in_used` integer, required
  - `tokens_out_used` integer, required
  - `tokens_in_limit` integer, required
  - `tokens_out_limit` integer, required
  - `period` string
  - `period_start` string, required
  - `period_end` string, required

---

[API](https://skmtc.dev/metacognition/apis/tex-api.md) - [All operations](https://skmtc.dev/metacognition/apis/tex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacognition/apis/tex-api/revisions/3bef47e50f2e?raw)