---
title: "Search patients"
method: GET
path: "/Patient"
tags: ["Patient"]
---

# Search patients

`GET /Patient`

Searches for `Patient` resources within the clinic the token belongs to. Returns a `Bundle` of type `searchset`, never a bare array. No matches is a `200` with `total: 0`, not a `404`.

Every parameter narrows the result: they combine with AND, never OR.

`total` counts the matches across every page, not the page returned. To walk the pages, follow the `next` link in the Bundle and send that URL unchanged.

Sorting is not supported, so the order of results is stable but not meaningful.

## Query parameters

- `_id` string
- `_lastUpdated` string
- `_count` integer
- `_page` string
- `name` string
- `family` string
- `given` string
- `birthdate` string, date
- `gender` 'male' | 'female' | 'other' | 'unknown'
- `telecom` string

## Response `200`

A searchset Bundle of matching resources.

## Other responses

- `401` — Unauthorized - missing or invalid bearer token.
- `403` — Forbidden - the token lacks the required scope.

---

[API](https://skmtc.dev/mdhub/apis/mdhub-api.md) · [All operations](https://skmtc.dev/mdhub/apis/mdhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mdhub/mdhub-api/revisions/ee7fca23d80b/schema)