---
title: "POST /api/lab_tests"
method: POST
path: "/api/lab_tests"
tags: ["Clinical"]
---

# POST /api/lab_tests

`POST /api/lab_tests`

Create lab tests. An example lab workflow is as following:

- When you get orders, submit them via `/api/lab_orders`, such that doctors can see them in drchrono.

- When results come in, submit the result document PDF via `/api/lab_documents` and submit the results data via `/api/lab_results`

- Update `/api/lab_orders` status

## Query parameters

- `order` integer
- `doctor` integer

## Response `201`

Created

- LabTest
  - `report_notes` string — Notes which are not meant for labs, but are copied on the results.
  - `status` 'P' | 'I' | 'C' | 'F' | 'X' — One of `"preliminary"`, `"pending"`, `"correction"`, `"final"` or `"canceled"`. Defaults to `"preliminary"`
  - `code` string
  - `description` string — Short description of the ICD-10 code
  - `specimen_condition` string
  - `collection_date` string — The date the specimen were collected
  - `internal_notes` string — Notes which are meant for, and read by, the labs
  - `specimen_total_volume` number
  - `specimen_source` string
  - `lab_order` integer, required — ID of associated lab order
  - `id` integer
  - `name` string — Name for the test

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Permission Denied
- `404` — Not Found
- `405` — Method Not Allowed
- `500` — Internal Server Error

---

[API](https://skmtc.net/drchrono/apis/untitled-api.md) · [All operations](https://skmtc.net/drchrono/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drchrono/untitled-api/versions/e595797fe800/schema)