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

# List Knowledge Bases

Retrieve all knowledge bases created by the authenticated user.

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `pending`, `running`, `completed`, `failed`
</ParamField>

<ParamField query="processing_engine" type="string">
  Filter by processing engine: `milvus`
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.artaios.ai/api/v1/knowledge-bases/?status=completed" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.artaios.ai/api/v1/knowledge-bases/",
      headers={"x-api-key": "YOUR_API_KEY"},
      params={"status": "completed"}
  )
  knowledge_bases = response.json()
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.artaios.ai/api/v1/knowledge-bases/?status=completed', {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  });
  const knowledgeBases = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
[
  {
    "id": "kb_123",
    "name": "Product Knowledge Base",
    "description": "Product documentation and guides",
    "processing_engine": "milvus",
    "status": "completed",
    "progress": 100,
    "datasource_count": 2,
    "datasources": [
      {
        "id": "ds_123",
        "name": "manual.pdf",
        "type": "file-upload",
        "status": "active"
      }
    ],
    "ingested_datasources": [
      {
        "id": "ds_123",
        "name": "manual.pdf",
        "type": "file-upload",
        "status": "active"
      }
    ],
    "failed_datasources": [],
    "datasource_errors": {},
    "datasource_snapshots": {
      "ds_123": {
        "id": "ds_123",
        "name": "manual.pdf",
        "type": "file-upload",
        "ingestion_status": "ingested"
      }
    },
    "success_rate": 100,
    "processing_metadata": {},
    "created_by_name": "John Doe",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:35:00Z"
  }
]
```