---
title: "GET /api/lab_results"
method: GET
path: "/api/lab_results"
tags: ["Clinical"]
---

# GET /api/lab_results

`GET /api/lab_results`

Retrieve or search lab results

## Query parameters

- `cursor` string — The pagination cursor value.
- `page_size` integer — Number of results to return per page.
- `order` integer
- `doctor` integer

## Response `200`

OK

- object — Paginated Result
  - `previous` string — Previous paginated page
  - `data` LabResult[] — result data
    - `status` 'P' | 'I' | 'C' | 'F' | 'X', required — Value | Notes ----- | ----- `'P'` | `'preliminary'` `'I'` | `'pending'` `'C'` | `'correction'` `'F'` | `'final'` `'X'` | `'canceled'`
    - `group_code` string — This is the code used for grouping result data.
    - `observation_description` string — For example, ``"Blood Urea Nitrogen (BUN)"``
    - `is_abnormal` string — If true, the result will be flagged for the doctor's attention
    - `observation_code` string
    - `specimen_received` string
    - `comments` string
    - `normal_range` string — When ``value_is_numeric`` is True, this parameter must be a string of the form ``"<lower> <upper>", where both lower and upper are numerical``
    - `test_performed` string, required
    - `value` string, required
    - `abnormal_status` 'L' | 'LL' | 'H' | 'HH' | '<' | '>' | 'A' | 'AA' | 'S' | 'R' | 'I' | 'NEG' | 'POS' | 'N' | '' — Value | Notes ----- | ----- `'L'` | `'low'` `'LL'` | `'alert low'` `'H'` | `'high'` `'HH'` | `'alert high'` `'<'` | `'panic low'` `'>'` | `'panic high'` `'A'` | `'abnormal'` `'AA'` | `'very abnormal'` `'S'` | `'susceptible'` `'R'` | `'resistant'` `'I'` | `'intermediate'` `'NEG'` | `'negative'` `'POS'` | `'positive'` `'N'` | `'normal'` `''` | `'no comment'`
    - `lab_order` string — ID of `/lab_orders` object the result belongs to
    - `value_is_numeric` boolean — Default to `False`
    - `document` integer, required — ID of `/lab_documents` object for the result
    - `lab_test` integer, required — ID of `/lab_tests` object for the result
    - `id` integer
    - `unit` string — Unit used for the value
  - `next` string — Next Paginated page

## 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)