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

# List knowledge bases

> Retrieve all knowledge bases on your account.

Returns all knowledge bases associated with your account. Knowledge bases store documents that provide context to your AI assistants.

## Endpoint

`GET /user/knowledgebases`

## Response

<ResponseField name="data" type="array">
  Array of knowledge base objects.

  <Expandable title="Knowledge base properties">
    <ResponseField name="id" type="integer">Unique identifier of the knowledge base.</ResponseField>
    <ResponseField name="name" type="string">Name of the knowledge base.</ResponseField>
    <ResponseField name="description" type="string">Optional description.</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 knowledge base.</ResponseField>
    <ResponseField name="assistants_count" type="integer">Number of assistants using this knowledge base.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 creation timestamp.</ResponseField>
    <ResponseField name="updated_at" type="string">ISO 8601 last update timestamp.</ResponseField>
  </Expandable>
</ResponseField>

## Knowledge base statuses

| Status       | Description                                |
| ------------ | ------------------------------------------ |
| `empty`      | No documents have been added yet.          |
| `processing` | One or more documents are being processed. |
| `active`     | All documents are processed and ready.     |
| `failed`     | One or more documents failed to process.   |

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://portal.intellixent.ai/api/user/knowledgebases" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://portal.intellixent.ai/api/user/knowledgebases', {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  const data = await response.json();
  console.log(data.data); // Array of knowledge bases
  ```
</CodeGroup>

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