> ## 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.

# List Knowledge Base Items

> Retrieves a paginated list of knowledge base items for the authenticated organization.

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.

### 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 base items.

**data.kbs** `array`

Array of knowledge base item objects.

**data.kbs\[].id** `string`

Unique identifier for the knowledge base item.

**data.kbs\[].name** `string`

Name of the knowledge base item.

**data.kbs\[].description** `string`

Description of the knowledge base item (if provided).

**data.kbs\[].status** `string`

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

**data.kbs\[].type** `string`

Type of knowledge base item: `"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 base items.

**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 base items in the organization.

**errors** `null`

Will be `null` on successful request.

```bash Basic Request theme={null}
curl -X GET https://api.bland.ai/v1/knowledge \
  -H "authorization: Bearer YOUR_API_KEY"
```

```bash With Pagination theme={null}
curl -X GET "https://api.bland.ai/v1/knowledge?page=2&limit=10" \
  -H "authorization: Bearer YOUR_API_KEY"
```

```json Success Response theme={null}
{
  "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](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.