--- title: "List Lab Orders" method: GET path: "/api/2.0/lab_orders/" tags: ["Lab Orders"] --- # List Lab Orders `GET /api/2.0/lab_orders/` Returns a list of lab orders ## 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 - `from_signed_date` string, date-time - `limit` integer - `offset` integer - `order_by` string - `patient` integer[] - `practice` integer[] - `to_signed_date` string, date-time - `unsigned` boolean ## Response `200` - PaginatedLabOrderList - `count` integer - `next` string, uri, nullable - `previous` string, uri, nullable - `results` LabOrder[], required - `answers` LabOrderAOEAnswer[], nullable — List of the answers provided for the Ask on Entry (AOE) questions if required by any lab order tests. - `created_date` string, date-time, nullable — When the answer was created. - `deleted_date` string, date-time, nullable — When the answer was deleted. - `id` integer - `question` integer, required — The id of the AOE question for which this answer pertains. - `test` integer, nullable — The id of the test for which this answer pertains. - `value` string, nullable — The value entered by freetext or chosen by the ordering physician. - `bill_type` union — Who is financially responsible for the order. * `thirdparty` - Third Party (e.g. Insurance) * `patient` - Patient * `client` - Client * `workerscomp` - Worker's Comp * `specialbilling` - Special Billing - 'thirdparty' | 'patient' | 'client' | 'workerscomp' | 'specialbilling' — * `thirdparty` - Third Party (e.g. Insurance) * `patient` - Patient * `client` - Client * `workerscomp` - Worker's Comp * `specialbilling` - Special Billing - unknown - `ccs` integer[] — List of physician ids who should be cc'd on any reports. - `chart_date` string, date-time — Date at which this order was first seen in the patient's chart. - `confidential` boolean — Whether the provider has marked the order as confidential. Should not be shared with a patient. - `content` LabOrderContent - `collection_datetime` string, date-time, nullable — If lab specimen collection is done onsite, this is the time at which the collection was taken. - `fasting_method` union — Instructions for patient and lab on how long they should fast before specimen collection. * `fasting_12_hour` - Fasting - 12 hours * `fasting_8_hours` - Fasting - 8 hours * `fasting_2_hours` - Fasting - 2 hours * `fasting_none` - Non-Fasting * `fasting_random` - Fasting or non-fasting does not matter (Random) - 'fasting_12_hour' | 'fasting_8_hours' | 'fasting_2_hours' | 'fasting_none' | 'fasting_random' — * `fasting_12_hour` - Fasting - 12 hours * `fasting_8_hours` - Fasting - 8 hours * `fasting_2_hours` - Fasting - 2 hours * `fasting_none` - Non-Fasting * `fasting_random` - Fasting or non-fasting does not matter (Random) - '' - unknown - `icd10_codes` ICD10Code[] — ICD10 diagnosis codes provided along with the order. - `code` string, required - `description` string, nullable - `id` integer - `patient_instructions` string — Notes for patient. - `standing_order_end_date` string, date, nullable — Date at which standing order should be canceled. - `standing_order_frequency` string, nullable — Number of times order should be performed on a standing basis. - `stat_method` union - 'wet_reading_phone' | 'wet_reading_fax' | 'stat_phone' | 'stat_fax' | 'stat_phone_fax' — * `wet_reading_phone` - STAT Wet Reading - Please Phone Report * `wet_reading_fax` - STAT Wet Reading - Please Fax Report * `stat_phone` - STAT - Phone * `stat_fax` - STAT - Fax * `stat_phone_fax` - STAT - Phone and Fax - '' - unknown - `test_center_notes` string — Notes for Lab. - `tests` LabOrderTestWithDiagnoses[] — The list of tests that should be performed by the lab. Must all be either from the same compendium or no compendium. - `code` string, nullable — Any code associated with the test, usually provided by the lab vendor's compendium. - `compendium` integer, nullable — The id of the compendium provided the lab vendor that provides the lab order test. All tests in the same order **MUST** share the same compendium. - `cpts` string[] — A list of CPT codes associated with the lab order test. - `created_date` string, date-time, nullable — Time at which Elation created this Lab Order Test. - `deleted_date` string, date-time, nullable — Time at which this Lab Order Test was deleted. Can happen when a lab order compendium update deprecates a test. - `icd10_codes` ICD10Code[], required - `code` string, required - `description` string, nullable - `id` integer - `lab_vendor` integer, nullable — The id of the lab vendor who provides the lab order test. - `name` string, required — The name of the Lab Order Test. - `practice_created` integer, nullable — The id of the practice that created the test if practice created. - `procedure_class` string, nullable — Code provided by specific compendiums that indicate the "class" of test, e.g. histology vs cytology. Some lab vendors require that tests with specific procedure classes need to ordered separately. - `questions` LabOrderTestToLabOrderAOEQuestion[] — A list of Ask on Entry (AOE) Questions that need to be answered by the orderer when creating the order. - `question` LabOrderAOEQuestion, required - `choices` LabOrderAOEQuestionChoice[], required - … - `code` string, required - `created_date` string, date-time, nullable - `deleted_date` string, date-time, nullable - `example_format` string, nullable - `id` integer - `max_length` integer, nullable - `question_type` 'enum' | 'enum_multiselect' | 'freetext' | 'y_or_n' | 'numeric' | 'yyyymmdd' | '2_numeric_1_decimal' — * `enum` - enum * `enum_multiselect` - enum_multiselect * `freetext` - freetext * `y_or_n` - y_or_n * `numeric` - numeric * `yyyymmdd` - yyyymmdd * `2_numeric_1_decimal` - 2_numeric_1_decimal - `secondary_code` string, nullable - `value` string, required - `required` boolean - `sequence` integer, required - `test` integer - `synonyms` string[] — A list of synonyms that are useful when searching for a specific test. - `created_date` string, date-time, nullable — Time at which elation created this order. Can be different from chart_date when the order was imported into a chart from a different source and document_date when documenting an order that happened at some other time. - `deleted_date` string, date-time, nullable - `document_date` string, date-time, required — Time at which this order was created in whichever system created it. Could be historical or same as the create_date. - `facility` FacilityIdentifier - `active` boolean, required — Whether the facility identifier should be used. Should be true in most cases. - `bidi_connection` BiDiLabConnection - `alias` string, nullable — Get the alias of the connection. - `enabled` boolean — Get the enabled status of the connection. - `id` integer - `priority` integer - `protocol` string, nullable — Get the protocol of the connection. - `compendium` integer, nullable — The id of the compendium that will be used when the user selects this facility identifier. - `created_date` string, date-time, nullable - `deleted_date` string, date-time, nullable - `description` string, nullable — The text that will displayed to users in the lab order dialog. - `id` integer - `lab_connection` integer, nullable - `lab_facility` string, required — The id that represents the lab. - `practice` integer, required - `practice_facility` string, required — The id that represents the practice; often an account number provided by the lab vendor. - `practice_secondary_id` string, nullable - `user_facing` boolean — Whether this facility identifier will be visible in the lab order dialog. Should be true for most cases. - `vendor` object, required - `display_name` string - `id` integer - `name` string - `follow_up_method` string, nullable — Freetext field communicating how the patient should receive their results. - `id` integer - `ordering_physician` integer, required — The id of the physician who created the order. - `patient` integer, required — The id of the patient. - `practice` integer, required — The id of the practice. - `printable_view` string, uri - `requisition` integer — The requisition id of the order. Can be different from the order id if and when the order was created outside of Elation. - `resolution` DocumentResolutionState - `created_date` string, date-time, nullable — The datetime when this resolution state was created. - `deleted_date` string, date-time, nullable — The datetime when this resolution was deleted. Should never be null because we're providing the most updated resolution. - `document` integer — Will be the same as the id of the lab order. - `id` integer — Internal id to represent the resolution state. - `note` string, nullable — Any note that was added to represent why an order was cancelled. - `resolving_document` integer, nullable — If the order is fulfilled will indicate the document referenced. For lab orders will usually be a report. Must be an integer ID or null. - `state` 'outstanding' | 'fulfilled' | 'cancelled', required — * `outstanding` - Outstanding * `fulfilled` - Fulfilled * `cancelled` - Cancelled - `signed_by` integer, nullable — The id of the physician who signed off on the order. - `signed_date` string, date-time, nullable — The time when the order was signed. - `site` LabVendorPatientSite — The serializer for LabVendorPatientSite - `address` string — The address of the site. - `city` string — The city of the site. - `created_date` string, date-time, nullable - `deleted_date` string, date-time, nullable - `fax` string, nullable - `id` integer - `name` string, required - `phone` string, nullable - `practice_created` integer, nullable - `state` string - `suite` string, nullable - `vendor` LabVendorIdName — LabVendor Serializer useful for simple, read-only reference. - `display_name` string - `id` integer - `name` string - `zip` string - `special_insurance` PracticeSpecialInsuranceCodeName - `code` string, required - `name` string, required - `specimens` LabOrderSpecimen[], nullable — Record of any specimens collected when creating the order. - `body_site` BodySite, required - `code` string, required — The HL7 code representing the body site from which a specimen was collected. - `deleted_date` string, date-time, nullable — Represents if the body site was removed from the specimen. - `text` string, required — A textual description of the body site from which the specimen was collected. - `container_id` string, required — An identifier representing the container used to store the specimen. - `description` string, nullable — A freetext description of the specimen. - `id` integer - `lab_order` integer - `modifiers` LabOrderSpecimenModifier[], required — Coded Modifiers indicating more information about the body site from which the specimen was collected. - `deleted_date` string, date-time, nullable - `modifier` BodySiteCodeModifier, required - `code` string, required — The HL7 code representing the modifier on the body site from which a specimen was collected. - `deleted_date` string, date-time, nullable - `text` string, required — A textual description of the modifier of the body site from which the specimen was collected. - `sequence` integer, required — The cardinal position in which the modifiers should be listed. - `specimen` integer, required - `test` integer, required — The lab order test for which the specimen as collected. - `submissions` LabOrderSubmission[], nullable — Record of the attempts to submit. - `id` integer - `lab_order` integer - `state` string — The state of the electronic order submission. - `state_metadata` string, nullable — Useful error information collected as part of the submission. Including ERRORs or ACKs. - `time_acknowledged` string, date-time, nullable — The time at which a user acknowledged any error shown to them about the electronic submission. - `time_submitted` string, date-time, required — The time the electronic order was submitted to the lab vendor. - `tags` integer[] — Any tags associated with the lab order. - `test_date` string, date, nullable — The date on which the tests should be performed, or were performed. Can be different than document_date, create_date. - `vendor` integer, nullable --- [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)