The Lab Order Object

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

{
  "answers": [],
  "bill_type": null,
  "ccs": [],
  "chart_date": "2021-03-25T04:33:40Z",
  "confidential": false,
  "content": {
    // See Lab Order Content Object Definition
  },
  "create_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,
  "signed_by": 140754510217218,
  "signed_date": "2021-03-25T04:33:40Z",
  "site": null,
  "special_insurance": null,
  "submissions": [],
  "specimens": [],
  "tags": [],
  "test_date": null,
  "vendor": 67191701750
}

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',
'patient',
'client',
'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

dictionary

See Lab Order Content Object Definition

Represents the content of the lab order report.

created_date

datetime

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.

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.

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.

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.

Can be different from the order id if and when the order was created outside of elation.

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.

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.

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

The date on which the tests should be performed, or were performed.

Can be different than document_date, create_date

vendor

integer