# List the organization’s knowledge bases

Source: https://docs.usetone.ai/reference/knowledge/list

> Each with its derived status, document count and size.

`GET /v1/knowledge-bases`
Each with its derived status, document count and size. Status is computed, not stored: a base is `empty`, `indexing`, `ready` or `error` based on what its last build did.

Requires the `read` scope.

## Response



### Example response

```json
{
  "data": [
    {
      "agentCount": 2,
      "chunkCount": 187,
      "compiledTokens": 0,
      "createdAt": "2026-08-25T09:14:22Z",
      "deliveryMode": "inline",
      "description": "Delivery timelines, COD rules and the returns window.",
      "docCount": 4,
      "error": null,
      "id": "9f1c2d84-4e3a-4f6c-b902-7d1e8a33c451",
      "name": "Shipping and returns policy",
      "status": "empty",
      "totalBytes": 248311,
      "updatedAt": "2026-08-25T09:14:22Z"
    }
  ]
}
```