---
title: "List knowledge bases"
method: GET
path: "/v1/knowledge-bases"
tags: ["Knowledge bases"]
---

# List knowledge bases

`GET /v1/knowledge-bases`

Returns a paginated list of knowledge bases for the account, sorted by most recently updated. Each item includes its sources and timestamps. Use page and size for pagination.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Paginated knowledge bases for this account (may be an empty page).

- PaginatedResponseKnowledgeBaseResponse — Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
  - `data` KnowledgeBaseResponse[] — List of items for the current page. Contains up to 'size' number of records.
    - `kbId` string, required — Use this id in the URL when fetching, updating, or deleting this knowledge base.
    - `name` string, required — Knowledge base name
    - `files` KnowledgeBaseFileResponse[], required — Ordered sources; each item has documentId, type, and content.
      - `documentId` string, required — Stable id for this source; use when updating or deleting a single document.
      - `type` 'file' | 'url' | 'text', required — Source row kind. In JSON request and response bodies.
      - `content` string, required — Stored link, path, or text for this source.
    - `createdAt` string, date-time, required — When the knowledge base was created.
    - `updatedAt` string, date-time, required — When the knowledge base or its sources were last changed.
  - `page` integer — Current page number (0-based index). Indicates which page of results is being returned.
  - `size` integer — Number of items requested per page. Determines the maximum size of the 'data' list.
  - `totalCount` integer — Total number of records available across all pages. Useful for calculating pagination on the client side.
  - `totalPages` integer — Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
  - `hasNext` boolean — Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
  - `hasPrevious` boolean — Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `413` — Payload Too Large
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

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