---
title: "Get Knowledge Base by ID"
method: GET
path: "/external/kb/{kb_id}"
tags: ["knowledgebase"]
---

# Get Knowledge Base by ID

`GET /external/kb/{kb_id}`

Retrieves a specific knowledge base by its ID. Rate limit: 60 requests per hour per workspace.

## Path parameters

- `kb_id` string, required

## Headers

- `X-API-KEY` string, required

## Response `200`

Knowledge base details retrieved successfully.

- object
  - `kb_id` string
  - `kb_name` string
  - `status` string — Processing status of the knowledge base
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `files` object[]
    - `file_id` string
    - `file_type` string
    - `file_size` number
    - `filename` string
    - `file_path` string
  - `urls` object[]
    - `file_id` string
    - `file_type` string
    - `file_size` number
    - `url` string
    - `file_path` string
  - `faqs` object[]
    - `file_id` string
    - `file_type` string
    - `file_size` number
    - `content` object

## Other responses

- `401` — Unauthorized - Invalid or missing API key.
- `404` — Knowledge base not found.
- `429` — Rate limit exceeded - Maximum 60 requests per hour.

---

[API](https://skmtc.net/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.net/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/versions/00b614a7714c/schema)
