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 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.
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.
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.
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.
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.