> ## Documentation Index
> Fetch the complete documentation index at: https://help.elationhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Lab Order Object

A lab order represents an order for a patient to perform some lab tests for a vendor.

```json theme={null}
{
  "answers": [],
  "bill_type": null,
  "ccs": [],
  "chart_date": "2021-03-25T04:33:40Z",
  "confidential": false,
  "content": {
    // See Lab Order Content Object Definition
  },
  "created_date": "2021-03-25T04:33:40Z",
  "document_date": "2021-03-25T04:33:40Z",
  "facility": null,
  "follow_up_method": "",
  "id": 140754512183329,
  "ordering_physician": 140754510217218,
  "patient": 140754511659009,
  "practice": 140754506678276,
  "requisition": 140754512183329,
  "resolution": {
    "id": 140754511659009,
    "document": 140754512183329,
    "resolving_document": 140754512183329,
    "state": "outstanding",
    "note": null,
    "created_date": "2021-03-25T04:33:40Z",
    "deleted_date": null
  },
  "signed_by": 140754510217218,
  "signed_date": "2021-03-25T04:33:40Z",
  "site": null,
  "special_insurance": null,
  "submissions": [],
  "specimens": [],
  "tags": [],
  "test_date": null,
  "vendor": 67191701750,
  "printable_view": "http://127.0.0.1/api/2.0/lab_orders/140758848962593/printable"
}
```

| Attribute                          | Type                         | Allowed Values                                                                          | Description                                                                                                                                                                                                                                |
| :--------------------------------- | :--------------------------- | :-------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| answers                            | List of Answers              |                                                                                         | List of the answers provided for the Ask on Entry (AOE) questions if required by any lab order tests.                                                                                                                                      |
| answers.test                       | integer                      |                                                                                         | The id of the test for which this answer pertains.                                                                                                                                                                                         |
| answers.question                   | integer                      |                                                                                         | The id of the AOE question for which this answer pertains.                                                                                                                                                                                 |
| answers.value                      | string                       |                                                                                         | The value entered by freetext or chosen by the ordering physician.                                                                                                                                                                         |
| answers.created\_date              | datetime                     |                                                                                         | When the answer was created.                                                                                                                                                                                                               |
| answers.deleted\_date              | datetime                     |                                                                                         | When the answer was deleted                                                                                                                                                                                                                |
| bill\_type                         | string                       | 'thirdparty',  <br />'patient',  <br />'client',  <br />'workerscomp', 'specialbilling' | Who is financially responsible for the order.                                                                                                                                                                                              |
| ccs                                | List\[integer]               |                                                                                         | List of physician ids who should be cc'd on any reports.                                                                                                                                                                                   |
| chart\_date                        | datetime                     |                                                                                         | Date at which this order was first seen in the patient's chart.                                                                                                                                                                            |
| confidential                       | boolean                      | true, false                                                                             | Whether the provider has marked the order as confidential. Should not be shared with a patient.                                                                                                                                            |
| content                            | object                       | See Lab Order Content Object Definition                                                 | Represents the content of the lab order report.                                                                                                                                                                                            |
| created\_date                      | datetime                     |                                                                                         | Time at which elation created this order.  <br />  <br />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. |
| document\_date                     | datetime                     |                                                                                         | Time at which this order was created in whichever system created it. Could be historical or same as the create\_date.                                                                                                                      |
| facility                           | Facility Identifier          |                                                                                         | An identifier that represents the facility placing the order.  <br />  <br />Usually assigned by the lab vendor.                                                                                                                           |
| follow\_up\_method                 | string                       |                                                                                         | Freetext field communicating how the patient should receive their results.                                                                                                                                                                 |
| id                                 | integer                      |                                                                                         | The id of the lab order in Elation's systems.  <br />  <br />Will be unique.                                                                                                                                                               |
| ordering\_physician                | integer                      |                                                                                         | The id of the physician who created the order.                                                                                                                                                                                             |
| patient                            | integer                      |                                                                                         | The id of the patient.                                                                                                                                                                                                                     |
| practice                           | integer                      |                                                                                         | The id of the practice.                                                                                                                                                                                                                    |
| requisition                        | integer                      |                                                                                         | The requistion id of the order.  <br />  <br />Can be different from the order id if and when the order was created outside of elation.                                                                                                    |
| resolution.id                      | integer                      |                                                                                         | Internal id to represent the resolution state.                                                                                                                                                                                             |
| resolution.document                | integer                      |                                                                                         | Will be the same as the id of the lab order.                                                                                                                                                                                               |
| resolution.resolving\_document     | integer                      |                                                                                         | If the order is fulfilled will indicate the document referenced.  <br />  <br />For lab orders will usually be a report.                                                                                                                   |
| resolution.state                   | string                       | outstanding,  <br />fulfilled,  <br />cancelled                                         | The resolution state of the order.                                                                                                                                                                                                         |
| resolution.note                    | string                       |                                                                                         | Any note that was added to represent why an order was cancelled.                                                                                                                                                                           |
| resolution.created\_date           | datetime                     |                                                                                         | The datetime when this resolution state was created.                                                                                                                                                                                       |
| resolution.deleted\_date           | datetime                     |                                                                                         | The datetime when this resolution was deleted. Should never be null because we're providing the most updated resolution.                                                                                                                   |
| signed\_by                         | integer                      |                                                                                         | The id of the physician who signed off on the order                                                                                                                                                                                        |
| signed\_date                       | datetime                     |                                                                                         | The time when the order was signed.                                                                                                                                                                                                        |
| site                               |                              |                                                                                         | The location where the patient will have the lab performed.  <br />  <br />Sites are specific to their lab vendor.                                                                                                                         |
| site.name                          | string(200)                  |                                                                                         | The name of the site.                                                                                                                                                                                                                      |
| site.address                       | string(200)                  |                                                                                         | The streetname of the site.                                                                                                                                                                                                                |
| site.suite                         | string(35)                   |                                                                                         |                                                                                                                                                                                                                                            |
| site.city                          | string(50)                   |                                                                                         |                                                                                                                                                                                                                                            |
| site.state                         | string(2)                    |                                                                                         |                                                                                                                                                                                                                                            |
| site.zip                           | string(10)                   |                                                                                         |                                                                                                                                                                                                                                            |
| site.phone                         | string(20)                   |                                                                                         |                                                                                                                                                                                                                                            |
| site.fax                           | string(20)                   |                                                                                         |                                                                                                                                                                                                                                            |
| special\_insurance                 |                              |                                                                                         | Used primarily to support specific electronic lab order integrations.                                                                                                                                                                      |
| special\_insurance.code            | string(5)                    |                                                                                         |                                                                                                                                                                                                                                            |
| special\_insurance.name            | string(64)                   |                                                                                         |                                                                                                                                                                                                                                            |
| submissions                        | List of Lab Order Submission |                                                                                         | Record of the attempts to submit                                                                                                                                                                                                           |
| submissions.state                  | string(20)                   |                                                                                         | The state of the electronic order submission.                                                                                                                                                                                              |
| submissions.time\_submitted        | datetime                     |                                                                                         | The time the electronic order was submitted to the lab vendor.                                                                                                                                                                             |
| submissions.time\_acknowledged     | datetime                     |                                                                                         | The time at which a user acknowledged any error shown to them about the electronic submission.                                                                                                                                             |
| submissions.state\_metadata        | string(1500)                 |                                                                                         | Useful error information collected as part of the submission.  <br />  <br /> Including ERRORs or ACKs.                                                                                                                                    |
| specimens                          | List of Lab Order Specimens  |                                                                                         | Record of any specimens collected when creating the order.                                                                                                                                                                                 |
| specimens.test                     | integer                      |                                                                                         | The lab order test for which the specimen as collected.                                                                                                                                                                                    |
| specimens.body\_site               |                              |                                                                                         | Information about the body site where the specimen was collected.                                                                                                                                                                          |
| specimens.body\_site.code          | string(16)                   |                                                                                         | The HL7 code representing the body site from which a specimen was collected                                                                                                                                                                |
| specimens.body\_site.text          | string(64)                   |                                                                                         | A textual description of the body site from which the specimen was collected.                                                                                                                                                              |
| specimens.body\_site.deleted\_date | datetime                     |                                                                                         | Represents if the body site was removed from the specimen.                                                                                                                                                                                 |
| specimens.description              | string(40)                   |                                                                                         | A freetext description of the specimen.                                                                                                                                                                                                    |
| specimens.container\_id            | integer                      |                                                                                         | An identifier representing the container used to store the specimen.                                                                                                                                                                       |
| specimens.modifiers                | List\[BodySiteModifer]       |                                                                                         | Coded Modifiers indicating more information about the body site from which the specimen was collected.                                                                                                                                     |
| specimens.modifiers.modifier.code  | string(3)                    |                                                                                         | The HL7 code representing the modifier on the body site from which a specimen was collected                                                                                                                                                |
| specimens.modifiers.modifier.text  | string(64)                   |                                                                                         | A textual description of the modifier of the body site from which the specimen was collected.                                                                                                                                              |
| specimens.modifiers.sequence       | integer                      |                                                                                         | The cardinal position in which the modifiers should be listed.                                                                                                                                                                             |
| tags                               | List of Coded Document Tags  |                                                                                         | Any tags associated with the lab order.                                                                                                                                                                                                    |
| test\_date                         | date                         | nullable                                                                                | The date on which the tests should be performed, or were performed.  <br />  <br />Can be different than document\_date, create\_date                                                                                                      |
| vendor                             | integer                      |                                                                                         |                                                                                                                                                                                                                                            |
