Get consultation status and messages
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
Payment gate information when triage is complete
Suggested actions based on current status