---
title: "Get chatActivity by id"
method: GET
path: "/chatActivities/{chatActivityId}"
tags: ["chatActivities"]
---

# Get chatActivity by id

`GET /chatActivities/{chatActivityId}`

## Path parameters

- `chatActivityId` string, required

## Response `200`

ChatActivity

- ChatActivityResponse — A ChatActivity represents an active conversation thread between a patient and staff in Luma Health's messaging hub, tracking assignment to an individual user or a group, its status such as unassigned, assigned, or closed, and details like the last message sent and any linked facilities. It records why a conversation was closed and flags whether the latest activity resulted from an automated message such as an appointment reminder or from a genuine unexpected reply needing attention. This resource underlies how staff triage, prioritize, and manage incoming patient messages across the organization.
  - `_id` string — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `patient` object — Patient
    - `_id` string — The ID of patient.
    - `isOnline` boolean — Patient is online or not.
    - `isOnTelehealthSession` boolean — Patient is on telehealth session or not.
  - `lastMessage` string — ID of Message
  - `status` 'closed' | 'assigned' | 'unassigned' — status
  - `assignee` object — Assignee
    - `_id` string — The ID of user.
    - `isOnline` boolean — User is online or not.
    - `isOnTelehealthSession` boolean — User is on telehealth session or not.
  - `groupAssignee` string — ID of Group
  - `previousAssignee` string — ID of User
  - `previousGroupAssignee` string — ID of Group
  - `statusReason` string — ID of a ChatActivityStatusReason, only used when status is "closed"
  - `description` string — Additional description of the statusReason. Some ChatActivityStatusReasons require a description.
  - `facilities` string[] — List of facilities where the patient linked to this chatActivity has appointments.
  - `priorityUpdatedAt` string, date-time — This date/time changes only when the chat is assigned or the patient gets a messsage. It can be used to sort the chatActivities on screen.
  - `lastIrregularAt` string, date-time — Indicates the last time an unexpected message was sent in the chat. An example is when patient gets an automated appointment reminder requesting to answer YES to confirm or NO to cancel, and patient replies with a completely different message.
  - `automated` boolean — Indicates if this chatActivity was created as a consequence of an automated message being sent out, such as an appointment reminder.

## Other responses

- `401` — Not authenticated
- `403` — Access token does not have the required scope

---

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