> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# List Documents

> List documents in a knowledge base

<ParamField header="Authorization" type="string" required>
  Bearer JWT Token
</ParamField>

<ParamField path="id" type="string" required>
  Knowledge base ID
</ParamField>

<ResponseField name="documents" type="array">
  List of documents

  <Expandable title="document object">
    <ResponseField name="id" type="string">
      Document unique identifier
    </ResponseField>

    <ResponseField name="fileName" type="string">
      File name
    </ResponseField>

    <ResponseField name="fileType" type="string">
      File MIME type
    </ResponseField>

    <ResponseField name="fileSize" type="number">
      File size in bytes
    </ResponseField>

    <ResponseField name="status" type="string">
      Processing status: `pending` | `processing` | `completed` | `failed`
    </ResponseField>

    <ResponseField name="chunkCount" type="number">
      Number of semantic chunks (available after processing is complete)
    </ResponseField>

    <ResponseField name="errorMessage" type="string">
      Error message (available when status is `failed`)
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Upload time (ISO 8601)
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://zeus-api.agentspro.cn/api/knowledge-base/kb_abc123/documents \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "documents": [
      {
        "id": "doc_xyz789",
        "fileName": "product-guide.pdf",
        "fileType": "application/pdf",
        "fileSize": 2048576,
        "status": "completed",
        "chunkCount": 45,
        "errorMessage": null,
        "createdAt": "2025-06-10T08:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>