Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HL7 FHIR Patient API

Patient demographic and identity resources

HL7 FHIR Patient API is one of 8 APIs that HL7 FHIR publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Patient. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a changelog.

This API exposes 4 operations across 2 paths, and defines 11 schemas. It is described by OpenAPI 3.1.0, at version 4.0.1.

Requests are made against a single base URL, https://fhir-server.example.com/fhir/R4.

4 operations 2 paths 11 schemas 2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
4.0.1
Base URL
https://fhir-server.example.com/fhir/R5
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

HL7 FHIR Patient API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (SMARTonFHIR) using the authorizationCode flow, exposing 7 scopes. By default, every request must be authenticated.

  • SMARTonFHIR — SMART on FHIR OAuth 2.0 authorization

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Patient 4

Patient demographic and identity resources

GET
/Patient
Search patients
searchPatient 9 params → 200400
POST
/Patient
Create a patient
createPatient body → 201400
GET
/Patient/{id}
Read a patient
readPatient 1 param → 200404
PUT
/Patient/{id}
Update a patient
updatePatient 1 param body → 200201400

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are Patient (13 properties), Address (9 properties), Bundle (6 properties), HumanName (6 properties). Each schema is shown below with its type and property counts.

CodeableConcept
object
2 properties
Bundle
object
A container for a collection of FHIR resources
6 properties 2 required
Address
object
9 properties
HumanName
object
6 properties
Reference
object
4 properties
Identifier
object
4 properties
OperationOutcome
object
2 properties 2 required
Patient
object
Demographics and administrative information about a patient
13 properties 1 required
Coding
object
5 properties
Meta
object
4 properties
ContactPoint
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hl7-fhir-patient-api-openapi.yml Raw ↑

Other APIs HL7 FHIR publishes across the network.

HL7 FHIR R5 Healthcare API
SMART on FHIR Authentication
HL7 FHIR Bundle API
HL7 FHIR Condition API
HL7 FHIR Encounter API
HL7 FHIR MedicationRequest API
HL7 FHIR Observation API