List documents in a knowledge base

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

Requires the read scope. A key with less gets 403 insufficient_scope.

Authorization

AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The knowledge base's id.

Response Body

`application/json`

curl -X GET "https://example.com/v1/knowledge-bases/string/documents"

{  "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"    }  ]}

Was this page helpful?

List documents in a knowledge base

Authorization

Path Parameters

Response Body

200application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`