---
title: "Retrieve Report"
method: GET
path: "/api/2.0/reports/{id}/"
tags: ["Reports"]
---

# Retrieve Report

`GET /api/2.0/reports/{id}/`

## Path parameters

- `id` integer, required

## Response `200`

- Report
  - `chart_date` string, date-time, required — The date used for chart chronology and ordering. May differ from document_date.
  - `created_date` string, date-time, nullable
  - `custom_title` string, nullable
  - `deleted_date` string, date-time, nullable
  - `document_date` string, date-time, required — The date when the report was created.
  - `files` S3RetrievingDocumentFile[], nullable — Files and photos to attach. Two modes: (1) External JSON metadata: set content_type='application/json; schema=el8_external_content_report' and provide 'external_content' JSON that includes a 'referenced_url' (and optional metadata). The JSON is stored and used to reference the external file; file bytes are not uploaded. (2) Binary upload: set content_type='application/octet-stream' and provide 'base64_content' (and optional 'original_filename'). When any file uses base64, all files in the same request must use base64. On GET, returns file references; download via the files retrieval endpoint. For JSON content, the retrieval endpoint returns the stored JSON metadata.
    - `base64_content` string
    - `content_type` string
    - `document` string, uri — URL to retrieve the document
    - `external_content` unknown
    - `id` integer
    - `original_filename` string
  - `grids` LabResultsGrid[] — Structured lab results grids. Each grid groups results by accession number and collection/resulted timestamps.
    - `accession_number` string, required
    - `collected_date` string, date-time, required — The datetime the specimens for this grid of data was collected from the patient.
    - `note` string, nullable, required
    - `resulted_date` string, date-time, required — The datetime this grid of data was calculated and resulted by the lab.
    - `results` LabResult[], required
      - `abnormal_flag` 'Abnormal' | 'Abnormal (applies to non-numeric results)' | 'Above high normal' | 'Alert high' | 'Alert low' | 'Below low normal' | 'Beta-lactamase Pos (B-lactamase antibiotic resistant).' | 'Better-use when direction not relevant' | 'Critical' | 'Critical abnormal' | 'Intermediate result' | 'Intermediate. Indicates for microbiology susceptibilities only.' | 'Moderately susceptible. Indicates for microbiology susceptibilities only.' | 'Negative' | 'Negative result' | 'Normal (applies to non-numeric results)' | 'Not Applicable' | 'Panic high' | 'Panic low' | 'Positive result' | 'Resistant. Indicates for microbiology susceptibilities only.' | 'Significant change down' | 'Significant change up' | 'Susceptible. Indicates for microbiology susceptibilities only.' | 'Very High' | 'Very susceptible. Indicates for microbiology susceptibilities only.' | 'Worse-use when direction not relevant', required
      - `is_abnormal` boolean, required
      - `note` string, nullable, required
      - `reference_max` string, nullable, required
      - `reference_min` string, nullable, required
      - `status` 'AMENDED' | 'CORRECTED' | 'DELETED' | 'ERROR' | 'FINAL' | 'PARTIAL' | 'PENDING' | 'PRELIMINARY' | 'RESULT CANCELED DUE TO NON-PERFORMANCE' | 'RESULTS ENTERED -- NOT VERIFIED' | 'RESULTS STATUS CHANGE TO FINAL. RESULTS DID NOT CHANGE ( DONT TRANSMIT TEST).', required
      - `test` LabTest, required
        - `code` string, required
        - `loinc` string, nullable, required
        - `name` string, required
      - `test_category` LabTestCategory, required
        - `description` string, required
        - `value` string, required
      - `text` string, nullable, required
      - `units` string, nullable
      - `value` string, required
      - `value_type` union
        - 'Coded Entry' | 'Encapsulated Data' | 'Numeric' | 'String Data' | 'Text'
        - unknown
    - `status` 'AMENDED' | 'CORRECTED' | 'DELETED' | 'ERROR' | 'FINAL' | 'PARTIAL' | 'PENDING' | 'PRELIMINARY' | 'RESULT CANCELED DUE TO NON-PERFORMANCE' | 'RESULTS ENTERED -- NOT VERIFIED' | 'RESULTS STATUS CHANGE TO FINAL. RESULTS DID NOT CHANGE ( DONT TRANSMIT TEST).', required
  - `id` integer
  - `images` ReportImage[], nullable — Read-only. Images derived from uploaded files. Upload using the 'files' field; retrieve specific images via the images endpoint.
    - `document` string, uri, required
    - `id` integer
  - `is_urgent` boolean
  - `order_status` union — Status of a linked order, when applicable.
    - 'CANCELED' | 'COMPLETED' | 'DISCONTINUED' | 'ERROR, ORDER NOT FOUND' | 'IN PROCESS' | 'ON HOLD' | 'REPLACED' | 'SCHEDULED'
    - unknown
  - `patient` integer, required — The patient this report belongs to. The patient must belong to the specified practice.
  - `physician` integer, required
  - `practice` integer, required — The authoring practice for this report. Required on create.
  - `printable_view` string, uri — URL to a printable PDF view of the report. You may pass the optional 'print_header' query param to select a header.
  - `report_type` 'Allergist' | 'Audiology' | 'Billing' | 'Business' | 'Cardiac' | 'CarePlan' | 'Consent' | 'Consultation' | 'Correspondence' | 'Cosmetic' | 'DME' | 'Dermatology' | 'Diabetes' | 'Directives' | 'EKG' | 'ENT' | 'Endocrinology' | 'Exams' | 'EyeVision' | 'Forms' | 'GI' | 'History' | 'Home' | 'Hospice' | 'Hospital' | 'Imaging' | 'Incoming' | 'Injection' | 'Insurance' | 'Intake' | 'Lab' | 'Legal' | 'Misc' | 'Neuro' | 'Nursing' | 'OBGYN' | 'OT' | 'OldRecord' | 'Oncology' | 'Ophth' | 'Ortho' | 'Outgoing' | 'PT' | 'PaperRx' | 'Pathology' | 'PatientForm' | 'Pediatric' | 'Pharmacy' | 'Preop' | 'PriorAuth' | 'Procedures' | 'Psych' | 'Pulmonary' | 'Quality' | 'Radiology' | 'SNF' | 'Screening' | 'Sleep' | 'Surgery' | 'Testing' | 'Therapy' | 'Ultrasound' | 'UrgentCare' | 'Urology' | 'Women', required
  - `reported_date` string, date-time — The timestamp when the report was created by an external system, usually the same as "document_date".
  - `requisition_number` string, nullable
  - `routed_document_delegates` RoutedDocumentDelegate[] — Read-only. Users and groups that have been delegated to review this report.
    - `created_date` string, date-time, nullable
    - `deleted_date` string, date-time, nullable
    - `group` integer, nullable — ID of the delegated group. Null if this is a user delegation.
    - `id` integer
    - `user` integer, nullable — ID of the delegated user. Null if this is a group delegation.
  - `signed_by` integer, nullable
  - `signed_date` string, date-time, nullable
  - `tags` integer[] — Practice-scoped document tags.
  - `vendor` integer, nullable — Optional vendor for this report.

---

[API](https://skmtc.net/elationhealth/apis/api-authentication.md) · [All operations](https://skmtc.net/elationhealth/apis/api-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elationhealth/api-authentication/versions/c060f89d4de7/schema)