---
title: "Get a Knowledge Base V2"
method: GET
path: "/v2/knowledge-base/{id}"
tags: ["Knowledge Bases V2"]
---

# Get a Knowledge Base V2

`GET /v2/knowledge-base/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

- KnowledgeBaseV2WithFiles
  - `name` string, required
  - `description` string, nullable
  - `id` string, required
  - `orgId` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `files` KnowledgeBaseV2File[], required
    - `id` string, required
    - `knowledgeBaseV2Id` string, required
    - `fileId` string, required
    - `fileName` string
    - `mimetype` string
    - `bytes` number
    - `status` 'indexing' | 'ready' | 'failed', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `toolId` string, nullable, required — Id of the tool that searches this knowledge base (at most one per base; provisioned on creation). Attach it to an assistant via model.toolIds. Null when the base has no search tool yet.

---

[API](https://skmtc.dev/vapiai/apis/vapi-api.md) · [All operations](https://skmtc.dev/vapiai/apis/vapi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vapiai/vapi-api/revisions/872ff45af53b/schema)