---
schema_version: "1"
id: bf8b7e4f1fbdcacb400b18b9f79080c57565d66f8e82a49c0af6ad4b19eec087
title: Conversation Lists for iOS
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/messaging-in-app/guides/ios-conversation-lists.md
canonical_url: https://developer.salesforce.com/docs/service/messaging-in-app/guide/ios-conversation-lists.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 885ab0173d6fadf2450575b3315dfc02e5162c4ae99ebdd5bf0dfa6768bb9e30
products:
  - Enhanced In-App Chat
  - Service Cloud Developer Content
---
# Conversation Lists for iOS

The conversation list API allows you to structure your user interface around multiple distinct conversations. Using this API, you can access an ordered list of existing conversations and decide how you want to display that information to your users. This behavior is useful when you expect users to have more than one conversation ongoing with reps or bots.


**important:** This feature requires version 1.3.0 or later of the Enhanced In-App Chat SDK.


This article applies to the following implementations:

| UI SDK | Core SDK |
| :----: | :------: |
|   ✅   |    ✅    |


Regardless of whether you're using the UI SDK or the Core SDK, this feature requires that you create your own user interface to display the list of conversations. From there, UI SDK implementations can drop into the built-in user interface provided by the SDK.


To access the list of conversations, use one of the `conversations()` methods on the [`CoreClient`](https://salesforce-async-messaging.github.io/messaging-in-app-ios/documentation/smiclientcore/coreclient) object.

```swift
coreClient.conversations(withLimit: 10, olderThanConversation: nil) { (conversations, error) in
    if error != nil {
        // TO DO: Handle error
        return
    }

    for conversation in conversations {
       // TO DO: Display each conversation
    }
}
```

**tip:** The `conversations` method that uses the `olderThanConversation` parameter (as shown above) queries the server to ensure that you have the latest information about the conversation list. The method that uses the `sortedByActivity` parameter only queries your local cached data for a list of conversations and may not reflect the latest conversation data. Cached data is updated after calling the `conversations` method that uses the `olderThanConversation` parameter.


See the reference documentation for [`CoreClient`](https://salesforce-async-messaging.github.io/messaging-in-app-ios/documentation/smiclientcore/coreclient) to learn more.