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

# List Documents

> List all documents stored in a specific Famulor knowledge base via API. Inspect filenames, sizes and indexing status used by AI voice assistants.

This endpoint returns a list of all documents in a specific knowledge base.

### Path Parameters

<ParamField path="knowledgebaseId" type="integer" required>
  The unique identifier of the knowledge base
</ParamField>

### Response Fields

<ResponseField name="data" type="array">
  Array of document objects

  <Expandable title="Document Properties">
    <ResponseField name="id" type="integer">
      The unique identifier of the document
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the document
    </ResponseField>

    <ResponseField name="description" type="string">
      Optional description of the document
    </ResponseField>

    <ResponseField name="type" type="string">
      Document type: `website`, `pdf`, `txt` or `docx`
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Human-readable type label
    </ResponseField>

    <ResponseField name="status" type="string">
      Processing status: `processing`, `active` or `failed`
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Human-readable status label
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of last update
    </ResponseField>
  </Expandable>
</ResponseField>

### Document Status

| Status       | Description                                                      |
| ------------ | ---------------------------------------------------------------- |
| `processing` | Document is being analyzed and embedded into the vector database |
| `active`     | Document has been processed and is ready to use                  |
| `failed`     | Document processing failed                                       |

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "id": 1,
        "name": "Product Handbook",
        "description": "Complete user manual for the product",
        "type": "pdf",
        "type_label": "PDF",
        "status": "active",
        "status_label": "Active",
        "created_at": "2025-01-05T10:30:00.000000Z",
        "updated_at": "2025-01-05T10:35:00.000000Z"
      },
      {
        "id": 2,
        "name": "Company Website",
        "description": "Main website content",
        "type": "website",
        "type_label": "Website",
        "status": "processing",
        "status_label": "Processing",
        "created_at": "2025-01-08T09:00:00.000000Z",
        "updated_at": "2025-01-08T09:00:00.000000Z"
      }
    ]
  }
  ```

  ```json 404 Knowledgebase Not Found theme={null}
  {
    "error": "Knowledgebase not found."
  }
  ```
</ResponseExample>

<Tip>
  Related pages: [Introduction](/en/api-reference/introduction) and [Authentication Guide](/en/developers/authentication-guide), and [API Integration Examples](/en/developers/api-integration-examples).
</Tip>