Knowledge Bases
List Knowledge Base Items
Retrieves a paginated list of knowledge base items for the authenticated organization.
GET
/
v1
/
knowledge
curl -X GET https://api.bland.ai/v1/knowledge \
-H "authorization: Bearer YOUR_API_KEY"
curl -X GET "https://api.bland.ai/v1/knowledge?page=2&limit=10" \
-H "authorization: Bearer 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 base items in your organization with pagination support. Use this endpoint to browse your available knowledge base items and their current status.
Docs for agents: llms.txt
Headers
Query Parameters
Response
Paginated list of knowledge base items.
Array of knowledge base item objects.
curl -X GET https://api.bland.ai/v1/knowledge \
-H "authorization: Bearer YOUR_API_KEY"
curl -X GET "https://api.bland.ai/v1/knowledge?page=2&limit=10" \
-H "authorization: Bearer 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
Was this page helpful?
⌘I
curl -X GET https://api.bland.ai/v1/knowledge \
-H "authorization: Bearer YOUR_API_KEY"
curl -X GET "https://api.bland.ai/v1/knowledge?page=2&limit=10" \
-H "authorization: Bearer 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
}