Get Conversation
Returns the current status, messages, and payment gate info for a consultation.
Authorizations
OAuth 2.1 with PKCE
Path Parameters
Consultation/conversation ID
Query Parameters
Whether to include message history
Response
Consultation details
Full conversation details with messages
A conversation is a continuous thread — it never "closes." There is no terminal CLOSED/CANCELED status: a finished or canceled request simply leaves the conversation IDLE with its visit history intact.
- IDLE: AI-only, nothing in progress. Re-engageable — sending a message re-runs triage
- TRIAGING: AI is gathering symptom information on a live request
- PAYMENT_REQUIRED: Triage complete, awaiting payment confirmation (or dismissal)
- MATCHING: Being matched with a healthcare provider
- WITH_PROVIDER: A provider is connected (messaging is asynchronous)
- EMERGENCY: Urgent care advised — user should call 911 (not re-engageable)
IDLE, TRIAGING, PAYMENT_REQUIRED, MATCHING, WITH_PROVIDER, EMERGENCY ISO 3166-2 region this conversation is licensed for
Present when a provider is in seat
Prior provider visits on this conversation
Windowed to the newest messages by default to keep long threads manageable; omittedOlderMessages reports how many older messages exist beyond the window.
Present when the message window truncated older messages
Timestamp of the newest message
Timestamp of the last status or lifecycle change; messages do not move it
While TRIAGING, the shortlist of what triage would most like to learn next. Gather the answers and send them in one message. Withheld when the patient's own message is newest on the thread.
The AI message informationNeed was computed on
Payment gate information when triage is complete
Suggested actions based on current status