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

# Get Knowledge Base

> Retrieves a specific knowledge base by ID.

Returns detailed information about a specific knowledge base, including its current status, metadata, and file information (if applicable).

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="knowledge_base_id" type="string" required>
  The unique identifier of the knowledge base to retrieve.
</ParamField>

### Response

<ResponseField name="data" type="object">
  The knowledge base object.

  <ResponseField name="data.id" type="string">
    Unique identifier for the knowledge base.
  </ResponseField>

  <ResponseField name="data.name" type="string">
    Name of the knowledge base.
  </ResponseField>

  <ResponseField name="data.description" type="string">
    Description of the knowledge base (if provided).
  </ResponseField>

  <ResponseField name="data.status" type="string">
    Current status: `"PROCESSING"`, `"COMPLETED"`, `"FAILED"`, or `"DELETED"`.
  </ResponseField>

  <ResponseField name="data.type" type="string">
    Type of knowledge base: `"FILE"`, `"WEB_SCRAPE"`, or `"TEXT"`.
  </ResponseField>

  <ResponseField name="data.source_urls" type="string">
    Source URLs for web scrape type (comma-separated).
  </ResponseField>

  <ResponseField name="data.base_url" type="string">
    Base URL for web scrape type.
  </ResponseField>

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

  <ResponseField name="data.updated_at" type="string">
    ISO timestamp of last update.
  </ResponseField>

  <ResponseField name="data.error_message" type="string">
    Error message if status is `"FAILED"`.
  </ResponseField>

  <ResponseField name="data.file" type="object">
    File information for file-type knowledge bases.

    <ResponseField name="data.file.file_name" type="string">
      Original filename.
    </ResponseField>

    <ResponseField name="data.file.file_size" type="number">
      File size in bytes.
    </ResponseField>

    <ResponseField name="data.file.file_type" type="string">
      MIME type of the file.
    </ResponseField>
  </ResponseField>
</ResponseField>

<ResponseField name="errors" type="null">
  Will be `null` on successful request.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
    -H "authorization: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "data": {
      "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T",
      "name": "Company FAQs",
      "description": "Frequently asked questions and policies",
      "status": "COMPLETED",
      "type": "FILE",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:32:00Z",
      "file": {
        "file_name": "company_faqs.pdf",
        "file_size": 2048576,
        "file_type": "application/pdf"
      }
    },
    "errors": null
  }
  ```

  ```json Not Found Response theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "KB_ERROR",
        "message": "KB not found or access denied"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)