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
}
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
}
⌘I