# List knowledge base items

URL: /en/docs/api/v1/knowledge-base/get
Last Updated: 2026-07-30T21:15:44.949Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/knowledge-base

**List knowledge base items**

Retrieve all Q&A items in the knowledge base for the current tenant. The response returns base-locale content and does not apply locale overlays. List items omit `answer_md`; use the item detail endpoint when separately stored markdown content is required.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Responses:**

- `200` - List of base-locale knowledge base items for the current tenant.
  - `knowledgeBase` (array of KnowledgeBaseListItem (object), required)
    - `id` (string (uuid), required): Unique knowledge base item identifier
    - `question` (string, required): The base-locale question being answered
    - `answer` (string, required): Answer content. Supports Markdown.
    - `access_level` (enum: public | restricted | internal | requires_nda, required): Access level for this Q&A item
    - `tags` (array of string, required): Tags for categorization

  Example (Successful response):
  
  ```json
  {
  "knowledgeBase": [
    {
      "id": "kb-123",
      "question": "What is our data retention policy?",
      "answer": "We retain customer data for **7 years** as required by law.",
      "access_level": "public",
      "tags": [
        "gdpr",
        "data-retention",
        "legal"
      ]
    }
  ]
}
  ```
- `401` - Unauthorized
- `403` - Forbidden - insufficient permissions for knowledge base access
  - `error` (string)
- `404` - Not found - tenant or knowledge base access not found
  - `error` (string)
- `500` - Internal server error - Failed to load knowledge base

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/knowledge-base" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```

Fetch:

```JavaScript
const response = await fetch("https://app.orbiqhq.com/api/v1/knowledge-base", {
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
});

const { knowledgeBase } = await response.json();
```

requests:

```Python
import requests

response = requests.get(
    "https://app.orbiqhq.com/api/v1/knowledge-base",
    headers={
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json",
    },
)
knowledge_base = response.json()["knowledgeBase"]
```

