Report Types


Reports are distinct representations of electronic health records. Different reports are designed to serve different use cases. Human readable reports are available in PDF or HTML while reports for programmatic use cases are available as JSON.

Reports are compiled shortly after we get an authorization from an individual and retrieve the data from their healthcare providers.

There are different ways to download a report. Either manually from our Enterprise Portal or automatically, using the API or an automated ”push” delivery system.

Types of available reports and formats

You may want the data to be organized and presented differently to meet your use case. You may need to see the entirety of a patient’s medical record or a concise version. You may want to have the data organized historically or grouped by types. You may want to surface specific details only, such as lab results.

We provide a set of standard reports representing the same underlying patient medical record. You can download the reports in JSON, HTML or PDF.

Below, a list of the standard reports that we can make available.

CodeDescriptionAvailable Formats
clinicalhistory Clinical History
Clinical History is a complete medical record meant for full medical underwriting. Duplicate sections are removed resulting in significantly shorter records compared to the ccdraw Complete Medical Record report.

It is grouped into 2 major sections:
- The Clinical Timeline that shows encounter specific entries grouped by day
- The Summary Records section that shows summary entries that frequently span multiple days or years

This report is built to combine all available healthcare providers. Each provider authorized by the end consumer will be included in this report.

The Clinical History and Complete Medical Record reports both include the full health history available but Human API recommends the Clinical History Report for all use cases requiring a full medical record as it is significantly shorter without any data loss and offers much improved data formatting.
highlightsHighlights Summary

Provides a summary of profile and health measurements. Organizes results by test results, social history and key conditions.
healthcheckHealth Check Summary

Provides a summary of profile and health measurements related to test results. Organizes results by chemistries, cardiovascular risk, BMI, blood pressure, lipid panel.
apsAPS report

Attending Physician Statement. These range between a few dozen and several hundred pages of a patient’s medical history, including diagnoses, prescribed medications, and notes.
fhirFHIR report

Structured data output that follows the industry standard FHIR R4 schema. Output is a zip file containing a set of ndjson files containing problems, procedures, vitals, etc. This comprehensive output includes all the data available in the record, and is intended to be ingested into a database for programmatic and analytical use cases.

Legacy Reports (available, but have been replaced by improved options)

CodeDescriptionAvailable Formats
ccdrawComplete medical record

Superseded by the Clinical History report.
The entire medical record of a patient , directly rendered from the CCD-A documents. This report renders the data as close as it can get to the original charts retrieved from the source EHR.

This report is generated only when the user connects a data source that provides CCDA files. It’s typically not available from pharmacies or independent lab networks.

This report is built separately for each healthcare provider. Each provider authorized by the end consumer may have their own report.
apidataBulk export of the clinical API

This report aggregates the output of the main clinical API endpoints for a given individual. It’s equivalent to calling all the ​Clinical API​ endpoints (except ccd and narratives) and concatenating the responses together.