# Knowledge bases: List documents in a knowledge base (https://docs.envocal.ai/api-reference/knowledge-bases/list-documents-in-a-knowledge-base/)

> Requires knowledge:read

## GET `/v1/tenants/{tenantId}/knowledge-bases/{kbId}/documents`

**Required permission:** `knowledge:read`

### Parameters

| Name | In | | Type | Description |
| --- | --- | --- | --- | --- |
| `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. |
| `kbId` | path | required | string | Knowledge base id. |

### Responses

**200** — KnowledgeDocumentDto[]: The documents (empty if the knowledge base is not found in this tenant).

| Field | Type | | Description |
| --- | --- | --- | --- |
| `id` | string | required | Document id. |
| `fileName` | string | required | Original file name. |
| `mimeType` | string | required | File type, e.g. `application/pdf`. |
| `fileSize` | integer (int64) |  | Size in bytes. |
| `uploadedUtc` | string (date-time) |  | Upload time (UTC). |
| `version` | integer |  | Document version. |

**401**: Missing, invalid, revoked or expired API key.

**403**: The key lacks the required permission, or the tenant/resource is outside its reach.

**429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header.

### Example

```bash
curl -X GET "https://api.envocal.ai/v1/tenants/current/knowledge-bases/{kbId}/documents" \
  -H "Authorization: Bearer evk_eu_..."
```