# GET /api/knowledge-base/categories

> Knowledge Base - List Knowledge Base Categories

- **Endpoint:** `GET /api/knowledge-base/categories`
- **Group:** Knowledge Base
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/KnowledgeBaseController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | String | no | Optional area filter, knowledge_base or help. Defaults to knowledge_base |
| `include_internal` | Boolean | no | Optional, set to 1 to include the internal help area. Defaults to 0 |

## Request example

```bash
curl -X GET "https://yoursite.com/index.php/api/knowledge-base/categories" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
[
  {
    "id": "3",
    "title": "Getting started",
    "type": "knowledge_base",
    "status": "active",
    "sort": "1",
    "articles_order": "A-Z",
    "total_articles": "8"
  }
]
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/knowledge-base/get-knowledge-base-categories/