# GET /api/knowledge-base/articles

> Knowledge Base - List Knowledge Base Articles

- **Endpoint:** `GET /api/knowledge-base/articles`
- **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 |
| `status` | String | no | Optional article status, active or inactive. Only honoured when include_internal is 1 |
| `category_id` | Number | no | Optional filter by help category ID |
| `label_id` | Number | no | Optional filter by label ID |

## Request example

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

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
[
  {
    "id": "12",
    "title": "How to reset a password",
    "category_id": "3",
    "category_title": "Getting started",
    "type": "knowledge_base",
    "status": "active",
    "total_views": "41",
    "sort": "0"
  }
]
```

---

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-articles/