---
title: "List Message Threads"
method: GET
path: "/api/2.0/message_threads/"
tags: ["Message Threads"]
---

# List Message Threads

`GET /api/2.0/message_threads/`

## Query parameters

- `document_date__gt` string, date-time
- `document_date__gte` string, date-time
- `document_date__lt` string, date-time
- `document_date__lte` string, date-time
- `limit` integer
- `offset` integer
- `order_by` string
- `patient` integer[]
- `practice` integer[]

## Response `200`

- PaginatedMessageThreadList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` MessageThread[], required
    - `chart_date` string, date-time, required — When the message thread's patient chart was created.
    - `created_date` string, date-time, nullable — When the message thread was created.
    - `deleted_date` string, date-time, nullable — When the message thread was deleted.
    - `delivery_date` string, date-time, nullable
    - `document_date` string, date-time, required — When the message thread's document was created.
    - `id` integer
    - `is_urgent` boolean — Whether the message is currently urgent.
    - `members` ThreadMember[] — List of Thread Members, when creating only need to specify the id of the thread member and their status.
      - `ack_time` string, date-time — The time at which the member acknowledged the message thread.
      - `group` integer, nullable — The id of the group referenced by this thread member. Should only ever be one of either a user or group set for the thread member.
      - `id` integer
      - `status` 'Addressed' | 'Requiring Action', required
      - `thread` integer — The id of the thread this thread member is a member of.
      - `user` integer, nullable — The id of the user referenced by this thread member. Should only ever be one of either a user or group set for the thread member.
    - `messages` ThreadMessage[] — List of Thread Messages, when creating only need to provide the body, send_date and sender.
      - `body` string, required — The actual message body.
      - `id` integer
      - `patient` integer — The patient id.
      - `practice` integer — The practice id.
      - `send_date` string, date-time, required — The date of when the message was sent.
      - `sender` integer, required — The id of who sent the message.
      - `thread` integer — The message thread id.
      - `to_document` Document
        - `authoring_practice` integer, required
        - `chart_date` string, date-time, required — The creation date of the patient chart.
        - `created_date` string, date-time, nullable — The creation date of the document.
        - `deleted_date` string, date-time, nullable — The deleted date of the document.
        - `document_date` string, date-time, required — The date of the document. In most cases it's the same as the creation date. For some documents, like visit notes, it's the date of the visit note.
        - `document_type` integer, nullable
        - `id` integer, required
        - `last_modified` string, date-time
        - `patient` integer, required
        - `sign_date` string, date-time, nullable — The date of when the document was signed (if signed).
        - `signed_by` integer — The id of whoever signed the document (if signed).
    - `patient` integer, required — The patient chart for which the thread is about.
    - `practice` integer, required — The id of the practice that owns the patient chart.
    - `signed_by` integer, nullable — The user who signed the thread
    - `signed_date` string, date-time, nullable — The date and time when the thread was signed

---

[API](https://skmtc.net/elationhealth/apis/api-authentication.md) · [All operations](https://skmtc.net/elationhealth/apis/api-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elationhealth/api-authentication/revisions/c060f89d4de7/schema)