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

# Get knowledgebases

> Get all knowledgebases for the authenticated user

This endpoint returns a list of all knowledgebases associated with your account. Knowledgebases are used to store documents that provide context and information to your AI assistants.

### Response

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

  <Expandable title="knowledgebase properties">
    <ResponseField name="id" type="integer">
      The unique identifier of the knowledgebase
    </ResponseField>

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

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

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

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

    <ResponseField name="documents_count" type="integer">
      Number of documents in this knowledgebase
    </ResponseField>

    <ResponseField name="assistants_count" type="integer">
      Number of assistants using this knowledgebase
    </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>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "data": [
      {
        "id": 1,
        "name": "Product Documentation",
        "description": "Technical documentation for our products",
        "status": "active",
        "status_label": "Active",
        "documents_count": 5,
        "assistants_count": 2,
        "created_at": "2025-01-05T10:30:00.000000Z",
        "updated_at": "2025-01-08T14:20:00.000000Z"
      },
      {
        "id": 2,
        "name": "FAQ Knowledge",
        "description": "Frequently asked questions and answers",
        "status": "processing",
        "status_label": "Processing",
        "documents_count": 1,
        "assistants_count": 0,
        "created_at": "2025-01-08T09:00:00.000000Z",
        "updated_at": "2025-01-08T09:05:00.000000Z"
      }
    ]
  }
  ```

  ```json 200 Empty Response theme={null}
  {
    "data": []
  }
  ```
</ResponseExample>

### Knowledgebase Statuses

| Status       | Description                               |
| ------------ | ----------------------------------------- |
| `empty`      | Knowledgebase has no documents            |
| `processing` | One or more documents are being processed |
| `active`     | All documents are processed and ready     |
| `failed`     | One or more documents failed to process   |