# Query Conversations

{% hint style="danger" %}
**Requires *****`READ_SMS`***** permission.**
{% endhint %}

Add the following permission in your `AndroidManifest.xml`

```markup
<uses-permission android:name="android.permission.READ_SMS"/>
```

## getConversations()

#### Returns Future\<List<[SmsConversation](#smsconversation)>>

| Parameters | Type                                                                      | Description                                                             | Optional | Default Value |
| :--------: | ------------------------------------------------------------------------- | ----------------------------------------------------------------------- | :------: | ------------- |
|   Filter   | [`ConversationFilter`](#conversationfilter)                               | Filters the result by given constraints. Works like `SQL WHERE` clause. |    ✔️    | `null`        |
|  sortOrder | List of [`OrderBy`](https://telephony.shounakmulay.dev/query-sms#orderby) | Sorts the result prioritized by order of declaration.                   |    ✔️    | `null`        |

```dart
List<SmsConversation> conversations = await telephony.getConversations(
        filter: SmsFilter.where(ConversationColumn.THREAD_ID)
                 .equals("12")
                 .and(ConversationColumn.SNIPPET)
                 .like("starwars"),
        sortOrder: [OrderBy(ConversationColumn.THREAD_ID, sort: Sort.ASC)]
        );
```

#### All parameters are optional.

```dart
List<SmsConversation> conversations = await telephony.getConversations();
```

## SmsConversation

| Property           | Type     |
| ------------------ | -------- |
| **`snippet`**      | `String` |
| **`threadId`**     | `int`    |
| **`messageCount`** | `int`    |

## ConversationColumn

| Values          |
| --------------- |
| **`SNIPPET`**   |
| **`THREAD_ID`** |
| **`MSG_COUNT`** |

## ConversationFilter

Works exactly like [`SmsFilter`](https://telephony.shounakmulay.dev/query-sms#smsfilter) but works with [`ConversationColumn`](#conversationcolumn) instead of [`SmsColumn`](https://telephony.shounakmulay.dev/query-sms#smscolumn)