---
title: "List Knowledge Bases"
method: GET
path: "/v2/ControlPlane/KnowledgeBases"
tags: ["KnowledgeBases"]
---

# List Knowledge Bases

`GET /v2/ControlPlane/KnowledgeBases`

Get a list of knowledge bases for the Twilio account.

## Query parameters

- `pageSize` integer
- `pageToken` string
- `orderBy` 'ASC' | 'DESC'

## Response `200`

Knowledge Bases retrieved successfully

- KnowledgeBaseList
  - `knowledgeBases` KnowledgeBase[] — List of Knowledge Bases associated with the Twilio account.
    - `displayName` string, required — Provides a unique and addressable name to be assigned to this Knowledge Base. This name is assigned by the developer and can be used in addition to the ID. It is intended to be human-readable and unique within the account.
    - `description` string — A human readable description of this resource, up to 128 characters.
    - `id` string, required — The unique identifier for the Knowledge Base
    - `status` 'QUEUED' | 'PROVISIONING' | 'ACTIVE' | 'FAILED' | 'DELETING', required — The provisioning status of the Knowledge Base
    - `createdAt` string, date-time, required — The ISO 8601 timestamp when the Knowledge Base was created.
    - `updatedAt` string, date-time, required — The ISO 8601 timestamp when the Knowledge Base was last updated.
    - `version` integer, required — The current version number of the Knowledge Base. Incremented on each successful mutable update.
  - `meta` Meta
    - `key` string — The key of the list property contains the actual data items. This enables programmatic iteration over paginated results.
    - `pageSize` integer — The number of items returned in this page of results.
    - `nextToken` string
    - `previousToken` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/twilio/apis/knowledge-v2.md) · [All operations](https://skmtc.dev/twilio/apis/knowledge-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/knowledge-v2/revisions/36dc1dbda0b4/schema)