# List Knowledge Base Groups

`GET /api/knowledge_base/groups`



- **Group:** Knowledge Base
- **Since:** v3.0.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/knowledge-base/get-kb-groups/

## Headers

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

## Example request

```bash
curl -X GET "https://yoursite.com/api/knowledge_base/groups" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Success response

### Success-Response:

```json
HTTP/1.1 200 OK
{
  "data": [
    {
      "groupid": "3",
      "name": "Billing & Payments",
      "group_slug": "billing-payments",
      "description": "Invoices, subscriptions and refunds",
      "active": "1",
      "color": "#28B8DA",
      "group_order": "2"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 5,
    "total_pages": 1,
    "has_more": false,
    "current_page": 1,
    "last_page": 1
  }
}
```

## Error responses

### Error-Response:

```json
HTTP/1.1 404 Not Found
{
  "status": false,
  "message": "No data were found"
}
```

---

Perfex CRM REST API by Themesic Interactive. Full reference: /apiguide/