---
title: "Changes to Get token usage for a set of documents"
method: POST
path: "/api/v0/documents/token-usage"
---

# Changes to Get token usage for a set of documents

`POST /api/v0/documents/token-usage`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-10-13** `7f81908bcdfe`: 4 info

## Changes

- **2026-10-13** `7f81908bcdfe`: 4 info
  - added the optional property `document_usage/items/cached_input_tokens` to the response with the `200` status
  - added the optional property `model_usage/items/cached_input_tokens` to the response with the `200` status
  - added the optional property `step_usage/items/cached_input_tokens` to the response with the `200` status
  - added the optional property `total_cached_input_tokens` to the response with the `200` status

---

[Operation](https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/documents/token-usage/post.md) - [API](https://skmtc.dev/outerport/apis/outerport-api.md) - [Page](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/documents/token-usage/post)