Project Health Insights request info
This page describes the request models and parameters that are used to interact with Project Health Insights service.
Request
The generic part of Project Health Insights request, common to all models.
Name | Required | Type | Description |
---|---|---|---|
patients |
yes | Patient[] | The list of patients, including their clinical information and data. |
Patient
A patient record, including their clinical information and data.
Name | Required | Type | Description |
---|---|---|---|
id |
yes | string | A given identifier for the patient. Has to be unique across all patients in a single request. |
info |
no | PatientInfo | Patient structured information, including demographics and known structured clinical information. |
data |
no | PatientDocument | Patient unstructured clinical data, given as documents. |
PatientInfo
Patient structured information, including demographics and known structured clinical information.
Name | Required | Type | Description |
---|---|---|---|
gender |
no | string | [ female, male, unspecified ] |
birthDate |
no | string | The patient's date of birth. |
clinicalInfo |
no | ClinicalCodeElement | A piece of clinical information, expressed as a code in a clinical coding system. |
ClinicalCodeElement
A piece of clinical information, expressed as a code in a clinical coding system.
Name | Required | Type | Description |
---|---|---|---|
system |
yes | string | The clinical coding system, for example ICD-10, SNOMED-CT, UMLS. |
code |
yes | string | The code within the given clinical coding system. |
name |
no | string | The name of this coded concept in the coding system. |
value |
no | string | A value associated with the code within the given clinical coding system. |
PatientDocument
A clinical unstructured document related to a patient.
Name | Required | Type | Description |
---|---|---|---|
type |
yes | string | [ note, fhirBundle, dicom, genomicSequencing ] |
clinicalType |
no | string | [ consultation, dischargeSummary, historyAndPhysical, procedure, progress, imaging, laboratory, pathology ] |
id |
yes | string | A given identifier for the document. Has to be unique across all documents for a single patient. |
language |
no | string | A 2 letter ISO 639-1 representation of the language of the document. |
createdDateTime |
no | string | The date and time when the document was created. |
content |
yes | DocumentContent | The content of the patient document. |
DocumentContent
The content of the patient document.
Name | Required | Type | Description |
---|---|---|---|
sourceType |
yes | string | The type of the content's source. If the source type is 'inline', the content is given as a string (for instance, text). If the source type is 'reference', the content is given as a URI.[ inline, reference ] |
value |
yes | string | The content of the document, given either inline (as a string) or as a reference (URI). |
Next steps
To get started using the service, you can
Feedback
Submit and view feedback for