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

# GET /api/lab_results

`GET /api/lab_results`

## Request

- Base URL: `https://app.drchrono.com`
- URL: `https://app.drchrono.com/api/lab_results`
- Auth: OAuth 2
  - Authorization code: `https://app.drchrono.com/o/authorize/`
  - Token URL: `https://app.drchrono.com/o/token/` scopes: `labs:read`, `labs:write`

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.dev/drchrono/apis/drchrono-api.md) - [All operations](https://skmtc.dev/drchrono/apis/drchrono-api/llms.txt) - [OpenAPI document](https://skmtc.dev/drchrono/apis/drchrono-api/revisions/98cabe79d150?raw)