# List documents in a knowledge base

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

> Each with its own indexing state, so you can tell one failing document from a failing base.

`GET /v1/knowledge-bases/{id}/documents`
Each with its own indexing state, so you can tell one failing document from a failing base.

Requires the `read` scope.

## Parameters

| Name | In | | Meaning |
|---|---|---|---|
| `id` | path | required | The knowledge base's id. |

## Response



### Example response

```json
{
  "data": [
    {
      "byteSize": 0,
      "charCount": 0,
      "createdAt": "2026-08-25T09:14:22Z",
      "error": null,
      "filename": "returns-policy.pdf",
      "id": "9f1c2d84-4e3a-4f6c-b902-7d1e8a33c451",
      "kind": "pdf",
      "mimeType": "application/pdf",
      "status": "awaiting_upload",
      "updatedAt": "2026-08-25T09:14:22Z"
    }
  ]
}
```