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

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

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.

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.
curl -X GET https://api.bland.ai/v1/knowledge \
  -H "authorization: YOUR_API_KEY"

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