> ## 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.

# Check Knowledge Base Status

Monitor processing status and health of a knowledge base during background ingestion.

<ParamField path="kb_id" type="string" required>
  The knowledge base ID
</ParamField>

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

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

  response = requests.get(
      "https://api.artaios.ai/api/v1/knowledge-bases/kb_123/check_status/",
      headers={"x-api-key": "YOUR_API_KEY"}
  )
  result = response.json()
  ```

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

## Response

Returns a success wrapper with the full knowledge base object:

```json theme={null}
{
  "success": true,
  "message": "Status checked for knowledge base 'Product Knowledge Base'",
  "knowledge_base": {
    "id": "kb_123",
    "name": "Product Knowledge Base",
    "status": "running",
    "progress": 45,
    "processing_engine": "milvus",
    "datasource_count": 15,
    "total_datasources": 15,
    "success_rate": 0,
    "ingested_datasources": [],
    "failed_datasources": [],
    "processing_metadata": {
      "phase": "batch_embedding",
      "total_chunks": 1250,
      "processed_chunks": 562,
      "message": "Generating Embeddings: 562/1,250 chunks"
    },
    "updated_at": "2025-01-15T10:35:00Z"
  },
  "status_updated": true
}
```

## Status Values

<AccordionGroup>
  <Accordion title="pending">
    Knowledge base created but processing not started
  </Accordion>

  <Accordion title="running">
    Collections are being processed and indexed
  </Accordion>

  <Accordion title="completed">
    All collections processed successfully
  </Accordion>

  <Accordion title="failed">
    Processing failed - check error details
  </Accordion>
</AccordionGroup>

<Tip>
  Use this endpoint to poll for status updates during background ingestion. The `processing_metadata` field provides detailed progress information.
</Tip>