---
title: "Get Month Summary"
method: GET
path: "/usage/summary"
tags: ["usage"]
---

# Get Month Summary

`GET /usage/summary`

## 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/summary`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/usage/summary/get.ts> (a function with typed inputs; its response is checked against the schema)

Calendar-month rollup of tokens_in / tokens_out for the caller's org.

## Query parameters

- `month` string, nullable: YYYY-MM (UTC). Defaults to current calendar month.

## Response `200`

Successful Response

- UsageWindow
  - `period` string, required: 'day' or 'month'
  - `start` string, required: ISO-8601 UTC start of window (inclusive)
  - `end` string, required: ISO-8601 UTC end of window (exclusive)
  - `tokens_in` integer, required
  - `tokens_out` integer, required

## Other responses

- `422`: Validation Error

---

[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)