---
title: "Retrieve knowledge usage"
method: GET
path: "/knowledge/usage"
tags: ["Knowledge"]
---

# Retrieve knowledge usage

`GET /knowledge/usage`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/knowledge/usage`
- Auth: HTTP bearer

Read the active indexed knowledge token quota, usage, remaining tokens and active chunk count. This is separate from per-file ten MiB upload limits and asset storage quota. Quota-limited ingestion can persist inactive knowledge; usage alone does not establish processing, scope, freshness, relevance or answer-time availability. Required permission: knowledge:read.

## Response `200`

Success

- KnowledgeUsage
  - `limitTokens` integer
  - `activeTokens` integer
  - `remainingTokens` integer
  - `activeChunks` integer

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)