# List messages in a conversation

**GET /conversation/search-entries**

Lists messages for the selected conversations of a case, with attachments, tags and comment counts. Dates are the device's wall-clock time labelled UTC.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters
### Headers

- **organization** (string)
  id of the selected (active) organization



### Query parameters

- **page** (number)

- **perPage** (number)

- **skip** (number)
  If skip/limit not provided, page/perPage will take precedence

- **limit** (number)
  If skip/limit not provided, page/perPage will take precedence

- **sortOrder** (string)

- **case** (string)
  Required if caseSlug not present

- **caseSlug** (string)
  Required if case not present

- **conversation** (string)
  ID of the conversation to search for

- **tags** (array[string])

- **excludeTags** (array[string])
  Exclude messages carrying any of these tag ids. Must not overlap `tags`.

- **untagged** (boolean)
  When truthy (1/true), return only messages with no tags attached. Takes precedence over the `tags`/`excludeTags` filters.

- **source** (string)

- **sources** (array[string])

- **linkedContacts** (array[string])

- **devices** (array[string])

- **startDate** (string(date-time))

- **endDate** (string(date-time))

- **hasAttachments** (number)
  0 false, 1 true

- **sortBy** (string)

- **sharedStatus** (string)
  Opposing-council only: filter to entries whose ocSharedStatus matches (e.g. `pending` for "show me what I have not shared yet"). Ignored for non-OC callers.



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)