# List conversation messages

{% hint style="warning" %}
All API requests should contain [authorization headers](https://developers.socialboards.com/docs/apis/tickets/authorization-headers).
{% endhint %}

**Request**

```
GET chat/conversations/{id}/messages
```

**Query parameters**

<table><thead><tr><th width="184">Field</th><th width="126">Type</th><th width="121">Required</th><th>Comments</th></tr></thead><tbody><tr><td>orderBy</td><td><a href="../enumerations/order-by">Order by</a> enumeration</td><td>false</td><td><p>Indicates the order of messages in the dialogue. </p><p>If set to <code>creation_time_asc</code> value, the system retrieves the earliest 100 messages; if set to <code>creation_time_desc</code>, it retrieves the latest 100 messages. </p><p>The default value is <code>creation_time_desc</code></p></td></tr><tr><td>skip</td><td>integer</td><td>true</td><td>Default value equal 0</td></tr><tr><td>take</td><td>integer</td><td>true</td><td>Maximum value equal 100. A default value equal 100</td></tr></tbody></table>

**Response**

```json
{
    "data": [
        {
            "author": {
                "email": "john@dow.com",
                "id": "fc2481f6-28a4-4ca7-849a-344fd6ab1b20",
                "image": null,
                "isBot": false,
                "name": "John",
                "status": "client"
            },
            "creationTime": "2023-08-22T14:50:07.21+00:00",
            "id": 667155,
            "lastModifiedTime": "2023-09-01T15:03:59.81+00:00",
            "message": "This is an external message created on a third-party platform"
        },
        {
            "author": {
                "email": "john@dow.com",
                "id": "fc2481f6-28a4-4ca7-849a-344fd6ab1b20",
                "image": null,
                "isBot": false,
                "name": "John",
                "status": "client"
            },
            "creationTime": "2023-08-22T14:50:15.21+00:00",
            "id": 667156,
            "lastModifiedTime": "2023-09-01T15:03:59.81+00:00",
            "message": "And this is another message from third-party platform"
        }
    ],
    "errorCode": -1,
    "errorText": null
}
```

The `Data` field contains an array of [Conversation message](https://developers.socialboards.com/docs/apis/external-chat-api/reference/objects/conversation-message) objects.