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

{
  "data": {
    "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"
    }
  },
  "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 detailed information about a specific knowledge base, including its current status, metadata, and file information (if applicable).

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
knowledge_base_id
string
required
The unique identifier of the knowledge base to retrieve.

​
Response

​
data
object
The knowledge base object.
​
data.id
string
Unique identifier for the knowledge base.
​
data.name
string
Name of the knowledge base.
​
data.description
string
Description of the knowledge base (if provided).
​
data.status
string
Current status: "PROCESSING", "COMPLETED", "FAILED", or "DELETED".
​
data.type
string
Type of knowledge base: "FILE", "WEB_SCRAPE", or "TEXT".
​
data.source_urls
string
Source URLs for web scrape type (comma-separated).
​
data.base_url
string
Base URL for web scrape type.
​
data.created_at
string
ISO timestamp of creation.
​
data.updated_at
string
ISO timestamp of last update.
​
data.error_message
string
Error message if status is "FAILED".
​
data.file
object
File information for file-type knowledge bases.
​
data.file.file_name
string
Original filename.
​
data.file.file_size
number
File size in bytes.
​
data.file.file_type
string
MIME type of the file.
​
errors
null
Will be null on successful request.
curl -X GET https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
  -H "authorization: YOUR_API_KEY"

{
  "data": {
    "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"
    }
  },
  "errors": null
}
Docs for agents: llms.txt