List Knowledge Bases

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

GET /v1/knowledge

Basic Request

curl -X GET https://api.bland.ai/v1/knowledge \
  -H "authorization: YOUR_API_KEY"

Success Response

{
  "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
}

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

Headers

authorization · string · required

Your API key for authentication.

Query Parameters

page · number · default: "1"

Page number for pagination.

limit · number · default: "20"

Number of items per page (maximum 100).

Response

data · object

Paginated list of knowledge bases.

data.kbs · array

Array of knowledge base objects.

data.kbs[].id · string

Unique identifier for the knowledge base.

data.kbs[].name · string

Name of the knowledge base.

data.kbs[].description · string

Description of the knowledge base (if provided).

data.kbs[].status · string

Current status: "PROCESSING", "COMPLETED", "FAILED", or "DELETED".

data.kbs[].type · string

Type of knowledge base: "FILE", "WEB_SCRAPE", or "TEXT".

data.kbs[].source_urls · string

Source URLs for web scrape type (comma-separated).

data.kbs[].base_url · string

Base URL for web scrape type.

data.kbs[].created_at · string

ISO timestamp of creation.

data.kbs[].updated_at · string

ISO timestamp of last update.

data.kbs[].error_message · string

Error message if status is "FAILED".

data.kbs[].file · object

File information for file-type knowledge bases.

data.kbs[].file.file_name · string

Original filename.

data.kbs[].file.file_size · number

File size in bytes.

data.kbs[].file.file_type · string

MIME type of the file.

data.total · number

Total number of knowledge bases in the organization.

errors · null

Will be null on successful request.

Basic Request

curl -X GET https://api.bland.ai/v1/knowledge \
  -H "authorization: YOUR_API_KEY"

Success Response

{
  "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
}

---

Docs for agents: llms.txt