Skip to main content
POST
Add results to an order
Creating results is asynchronous: a valid request creates a lab-result record, returns immediately with the lab_result_id, and queues the record for the EHR. A lab_result.created webhook is sent when processing completes. If the operation fails terminally, a lab_result.create_failed webhook is sent instead. Each result targets a component of the order. Reference a component by its component (name) or field_id, both of which come from the result_components returned by Get Order. Creating order results is only supported for eClinicalWorks.

Request Parameters

Required Fields

  • results (array, required): Result values, one per component. At least one entry is required. Each entry is an object with:
    • value (string or number, required): The result value.
    • component (string): The component name, from GET /v1/orders/{id}.
    • field_id (string): The component’s EMR id, from GET /v1/orders/{id}.
    Provide component or field_id to identify each component.

Optional Fields

  • result_date (string, optional): Result date (ISO 8601, YYYY-MM-DD). Defaults to today when omitted.
  • collected_date (string, optional): Specimen collection date (ISO 8601, YYYY-MM-DD).
  • collection_time (string, optional): Specimen collection time, e.g. "12:58 PM".
  • callback_urls (string[], optional): URLs to receive the lab_result.created webhook, in addition to the account webhook.

Example Request

Example Response

Webhook Notifications

When processing completes, we send a webhook to your registered endpoint.

Success

Failure

Authorizations

client_id
string
header
required
client_secret
string
header
required
access_token
string
header
required

Path Parameters

id
string
required

Cobalt order ID.

Body

application/json
results
object[]
required

Result values, one per component. Reference a component by component (its name, from GET /v1/orders/:id) or field_id.

Minimum array length: 1
result_date
string

Result date (ISO 8601, YYYY-MM-DD). Defaults to today when omitted.

collected_date
string

Specimen collection date (ISO 8601, YYYY-MM-DD).

collection_time
string

Specimen collection time, e.g. "12:58 PM".

callback_urls
string[]

URLs to receive the lab_result.created webhook, in addition to the account webhook.

Response

Lab result created and queued for the EMR

success
boolean
required
message
string
required
lab_result_id
string
required
order_id
string
required
job_id
required