---
title: "GET /list-knowledge-bases"
method: GET
path: "/list-knowledge-bases"
---

# GET /list-knowledge-bases

`GET /list-knowledge-bases`

List all knowledge bases

## Response `200`

Successfully retrieved all knowledge bases.

- KnowledgeBaseResponse[]
  - `knowledge_base_id` string, required — Unique id of the knowledge base.
  - `knowledge_base_name` string, required — Name of the knowledge base. Must be less than 40 characters.
  - `status` 'in_progress' | 'complete' | 'error' | 'refreshing_in_progress', required — Status of the knowledge base. When it's created and being processed, it's "in_progress". When the processing is done, it's "complete". When there's an error in processing, it's "error". When it is during kb updating, it's "refreshing_in_progress".
  - `max_chunk_size` integer — Maximum number of characters per chunk when splitting knowledge base content.
  - `min_chunk_size` integer — Minimum number of characters per chunk. Chunks smaller than this are merged with adjacent chunks.
  - `knowledge_base_sources` union[] — Sources of the knowledge base. Will be populated after the processing is done (when status is "complete").
    - union
      - KnowledgeBaseSourceDocument
        - `type` 'document', required — Type of the knowledge base source.
        - `source_id` string, required — Unique id of the knowledge base source.
        - `filename` string, required — Filename of the document.
        - `file_url` string, required — URL of the document stored.
        - `file_size` number, required — File size in bytes.
      - KnowledgeBaseSourceText
        - `type` 'text', required — Type of the knowledge base source.
        - `source_id` string, required — Unique id of the knowledge base source.
        - `title` string, required — Title of the text.
        - `content_url` string, required — URL of the text content stored.
      - KnowledgeBaseSourceUrl
        - `type` 'url', required — Type of the knowledge base source.
        - `source_id` string, required — Unique id of the knowledge base source.
        - `url` string, required — URL used to be scraped and added to the knowledge base.
  - `enable_auto_refresh` boolean — Whether to enable auto refresh for the knowledge base urls. If set to true, will retrieve the data from the specified url every 12 hours.
  - `last_refreshed_timestamp` integer — Last refreshed timestamp (milliseconds since epoch). Only applicable when enable_auto_refresh is true.

## Other responses

- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/retellai/apis/retell-sdk.md) · [All operations](https://skmtc.net/retellai/apis/retell-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/retellai/retell-sdk/versions/2a182bedbfc5/schema)