# GET /api/messages

> Messages - List all Messages

- **Endpoint:** `GET /api/messages`
- **Group:** Messages
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/MessagesController.php`

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `from_user_id` | Number | no | Optional filter by sender |
| `to_user_id` | Number | no | Optional filter by recipient |
| `status` | String | no | Optional filter by status (read, unread) |

## Request example

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

## Responses

### Success - Success-Response:

```json
[
  {
    "id": "1",
    "subject": "Hello",
    "message": "Content",
    "from_user_id": "1",
    "to_user_id": "2",
    "status": "unread"
  }
]
```

---

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