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

# POST /api/patients_list

`POST /api/patients_list`

Submit patient list request.  Use the UUID returned in the response to retrieve the batch of patients.

## Query parameters

- `order_by` string
- `page_size` integer — Number of results to return per page. Number between 1 and 1000.
- `first_name` string — Filter the list for the patient's first name.
- `last_name` string — Filter the list for the patient's last name.
- `preferred_language` string — Filter the list for the patient's preferred language.
- `gender` string
- `since` string
- `date_of_birth` string
- `race` string
- `chart_id` string
- `email` string
- `ethnicity` string
- `verbose` boolean

## Response `201`

Created

- object
  - `status` string — Status of the request. Possible values are "In progress" or "Complete".
  - `uuid` string — UUID of the batch of patients.
  - `description` string — Contains link to load the batch by UUID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Permission Denied
- `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)