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

# List Knowledge Base Collections

`GET /knowledge-bases`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/knowledge-bases`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### List Collections

Lists every collection in your company, newest first. Each item is enriched with documentCount and a rolled-up status the single-collection Get endpoint does not return.

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object[]
    - `knowledgeBaseId` string: Server-generated. Immutable. The identifier used everywhere for this collection.
    - `name` string: Up to 200 characters.
    - `description` string, nullable: Up to 1000 characters.
    - `documents` object
      - `embeddingStatus` 'pending' | 'processing' | 'completed' | 'failed'
      - `lastIndexedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `documentCount` number: Only present in the list response, not on a single collection fetched by id.
    - `status` 'empty' | 'processing' | 'ready' | 'failed': Rolled up from this collection's documents. Only present in the list response. Distinct from documents.embeddingStatus, which is a stored field on the collection itself.

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)