---
title: "Read knowledge base usage"
description: "How many items and characters of text the workspace keeps, against what its plan allows."
url: "https://openemail.uk/docs/api/knowledge/usage"
area: "API"
category: "Mailbox"
---

# Read knowledge base usage

How many items and characters of text the workspace keeps, against what its plan allows.

`GET /knowledge/usage`

## GET /knowledge/usage

How many items and characters of text the workspace keeps, against what its plan allows.

## Example

Needs `knowledge:read`. `limits` holds what the plan allows: 50 items and 1,000,000 characters on Free, 500 and 10,000,000 on Starter, 2,000 and 50,000,000 on Business, and 10,000 and 200,000,000 on Enterprise.

**curl**

```
curl "$OE/knowledge/usage" -H "$AUTH"
```

**Response**

```
{
  "object": "knowledge_usage",
  "plan": "starter",
  "sources": 18,
  "chars": 412088,
  "limits": { "sources": 500, "chars": 10000000 }
}
```

> The numbers are for the whole workspace, whatever the key may reach. Adding past the allowance is a 409 `knowledge_allowance_reached`.

## Reference

- [`GET /knowledge/usage`](https://openemail.uk/docs/api/reference/knowledge#get-knowledge-usage): full reference