Our id of the patient — the same value as patientId on the consult.
OptionalexternalYour id of the patient, when API-provisioned.
OptionalgivenGiven (first) name, if known.
OptionalfamilyFamily (last) name, if known.
OptionalbirthdateDate of birth, YYYY-MM-DD, if known.
OptionalsexBiological sex, if known.
OptionallangLocale of the patient's messages and notices, if set.
OptionalstateWhere the patient is (ISO 3166-2 subdivision, no country prefix), if recorded — the jurisdiction licensure routing was decided against.
The patient as a CLINICIAN'S screen needs them — the header of a queue row, an inbox thread, a call panel. Embedded on consult resources when the read is made with a physician credential, so a physician-facing UI can render a list of consults without one
GET /v1/patients/{id}per row.Deliberately a subset of PatientResource: no phone, no email, no channel — a physician working a queue needs to know WHO is next, not how to reach them outside the consult. Every field but
idis optional because the platform's own patients (those our agent opened consults for) are not always provisioned with the full record yourPOST /v1/patientsrequires.