Interface AsyncConsultResource

Consult id (also the webhook consultId and the embed token subject).

Our id of the patient on the thread.

Your id of the patient, when the patient was API-provisioned.

The patient's header card — see PatientSummary. Present on reads made with a physician credential (the inbox needs a name per row); absent on key-only reads, which already know their own patients.

Current lifecycle state.

Why the consult closed. Present exactly when status === 'closed'.

Clinical context you supplied at creation ("why they're here") — shown to the physician as the handoff summary.

The tenant specialty slug the thread was routed to, if any. Governs who auto-assignment may hand it to; a physician outside it may still claim.

Where the patient is (ISO 3166-2 subdivision, no country prefix), as recorded for licensure routing. Absent when never captured.

The patient's locale as it was when this consult was minted — the value language routing ranked the physicians against (their base language first, then English, then anyone; see ./languages). FROZEN on the row, so it is the routing truth for this thread and can differ from patient.lang, which is the patient's CURRENT setting and moves with every PATCH /v1/patients/{id}. Absent on threads minted before the language was recorded.

Which async modality this is (mirrors AsyncConsultMode): live — a thread picked up as soon as a clinician has capacity (the default, and every thread created before booking existed); scheduled — a thread booked for a chosen time. Absent means live.

Our id of the currently assigned physician (or the last assignee on a closed thread). Absent before first assignment.

Your id of the assigned physician, when API-provisioned.

Display name frozen at assignment (e.g. Dr. Sarah Chen, MD).

When the current physician was assigned.

Prior assignees, oldest first, when the thread was reassigned.

When the consult was created.

When the invite went out (creation time for API-origin consults).

When the patient consented. Absent while invited (or if declined).

Bumped on every message and lifecycle transition — the natural sort key.

When the consult reached its terminal state.

Set when the platform's safety layer detected a possible emergency in a patient message mid-thread. The patient already received a deterministic emergency response; this flags the thread for clinical attention.

Since when the ball has been in the physician's court: set when a patient message lands (or the thread is assigned with one waiting), cleared by the physician's reply. Absent means nothing is waiting on the clinician. The inbox sorts on it — oldest waiting first.

awaitingPhysicianSince + the response SLA (4 hours). Present exactly when awaitingPhysicianSince is; the instant the thread becomes eligible for takeover by another physician, and what a "due in …" badge counts down to.

True when responseDueAt has passed and the thread is still awaiting the assignee — the takeover condition, evaluated server-side at read time so a client never has to compare clocks. Always present (false when nothing is waiting).

When the patient last wrote on the thread.

When the assigned physician last replied.

When the physician marked the thread resolved — the start of the patient's acceptance window. Present while resolve_requested and on threads that closed out of it.

The note the physician attached to the resolve, if any.

How many times the SLA sweep moved this thread to another physician without anyone asking. A thread that keeps bouncing is the signal to look at the rota, not the thread.

Whether the patient may (still) rate this consult. Server-owned: true only for closed threads whose close reason earns a rating prompt and that have not been rated yet.

The rating, once submitted. Write-once.

Who opened it — see ConsultOrigin.