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

# List Knowledge Bases

> Retrieves a paginated list of knowledge bases for the authenticated organization.

Returns all knowledge bases in your organization with pagination support. Use this endpoint to browse your available knowledge bases and their current status.

### Headers

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

### Query Parameters

<ParamField query="page" type="number" default="1">
  Page number for pagination.
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of items per page (maximum 100).
</ParamField>

### Response

<ResponseField name="data" type="object">
  Paginated list of knowledge bases.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  <ResponseField name="data.total" type="number">
    Total number of knowledge bases in the organization.
  </ResponseField>
</ResponseField>

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

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

  ```bash With Pagination theme={null}
  curl -X GET "https://api.bland.ai/v1/knowledge?page=2&limit=10" \
    -H "authorization: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "data": {
      "kbs": [
        {
          "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"
          }
        },
        {
          "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V6U",
          "name": "Product Documentation",
          "description": "Complete product documentation from website",
          "status": "PROCESSING",
          "type": "WEB_SCRAPE",
          "source_urls": "https://example.com/docs/overview,https://example.com/docs/api",
          "base_url": "https://example.com",
          "created_at": "2025-01-15T11:00:00Z",
          "updated_at": "2025-01-15T11:00:00Z"
        }
      ],
      "total": 15
    },
    "errors": null
  }
  ```
</ResponseExample>

***

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