# GET /api/roles/search/{keyword}

> Roles - Search Roles (Read-Only)

Turns a role name into a role id. Search results never carry the permissions column.

- **Endpoint:** `GET /api/roles/search/{keyword}`
- **Group:** Roles
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/RolesController.php`

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `keyword` | String | yes | Search keywords, matched against the role title |

## Request example

```bash
curl -X GET "https://yoursite.com/index.php/api/roles/search/acme" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
[
  { "id": "1", "title": "Project manager" }
]
```

### Error - Error-Response:

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

---

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