---
title: "List Reports"
method: GET
path: "/api/2.0/reports/"
tags: ["Reports"]
---

# List Reports

`GET /api/2.0/reports/`

## Query parameters

- `document_date__gt` string, date-time
- `document_date__gte` string, date-time
- `document_date__lt` string, date-time
- `document_date__lte` string, date-time
- `limit` integer
- `offset` integer
- `order_by` string
- `patient` integer[]
- `practice` integer[]
- `reported_date__gt` string, date-time
- `reported_date__gte` string, date-time
- `reported_date__lt` string, date-time
- `reported_date__lte` string, date-time

## Response `200`

- PaginatedReportList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Report[], required
    - `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)