---
title: 'Patient (FHIR R5)'
description: 'Demographic and administrative information about an individual receiving healthcare services. Maps to HuliPractice patie'
nav: 'API / R5 / Patient'
order: 10
version: v1
fhir: r5
source: generated
updated: '2026-09-23'
---

# Patient (FHIR R5)

<FhirResourceHeader fhir="r5" slug="patient" />

Demographic and administrative information about an individual receiving healthcare services. Maps to HuliPractice patient records including name, birth date, gender, contact information, and identifiers such as CURP.

> This page is auto-generated from the server's FHIR R5 CapabilityStatement (`/fhir/R5/metadata`).

## FHIR R5 Specification

Official spec: [Patient — HL7 FHIR R5](https://hl7.org/fhir/R5/patient.html)

## Supported Interactions

- **read** — Read a single resource by ID (`GET /fhir/R5/{Resource}/{id}`)
- **search-type** — Search resources with query parameters (`GET /fhir/R5/{Resource}?...`)
- **create** — Create a new resource (`POST /fhir/R5/{Resource}`)
- **update** — Update an existing resource (`PUT /fhir/R5/{Resource}/{id}`)
- **$everything** — operation

## Scopes

Scopes are shared across FHIR releases — the same `system/Patient.*` scope grants Patient access on both `/fhir/R4` and `/fhir/R5`.

- <Scope name="system/Patient.rs" /> — see [scope reference](/v1/scopes#system-patient-rs)
- <Scope name="system/Patient.cru" /> — see [scope reference](/v1/scopes#system-patient-cru)

## Search Parameters

| Parameter | Type | Notes |
|-----------|------|-------|
| `_id` | token | Exact match. For identifiers use `system|value` format. |
| `identifier` | token | Exact match. For identifiers use `system|value` format. |
| `name` | string | Case-insensitive partial match. |
| `gender` | token | Exact match. For identifiers use `system|value` format. |
| `birthdate` | date | Supports FHIR date prefixes: `eq`, `ne`, `gt`, `ge`, `lt`, `le`. Format: `[prefix]YYYY-MM-DD`. |
| `active` | token | Exact match. For identifiers use `system|value` format. |
| `_count` | number | Integer. For `_count`: default 20, max 100. |
| `_cursor` | string | Case-insensitive partial match. |

## Endpoints

Operations, request/response examples, and code samples mirror the R4 surface — call them at `/fhir/R5` with the same token and scopes. See the [Patient R4 reference](/v1/api/r4/patient).