Huli FHIR R4 Server Capabilities

Huli FHIR Core Implementation Guide (R4) - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

CapabilityStatement: Huli FHIR R4 Server Capabilities

Official URL: https://fhir.huli.ai/r4/CapabilityStatement/huli-server				Version: 0.1.0
Active as of 2026-01-01				Computable Name:

Declared capabilities of the Huli Public FHIR R4 API at https://api.huli.io/fhir/R4.

Raw OpenAPI-Swagger Definition file | Download

Implementation Guide Version: 0.1.0
FHIR Version: 4.0.1
Supported Formats: json
Published on: 2026-01-01
Published by: Huli

Note to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: `server`

Security

Enable CORS: no

Security services supported: SMART-on-FHIR

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

The relevant profiles (if any)
The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
The required, recommended, and some optional search parameters (if any).
The linked resources enabled for _include
The other resources enabled for _revinclude
The operations on the resource (if any)

Resource Type	R	S	U	C	D	Searches	Operations
Patient	y	y	y	y		_id, identifier, name, gender, birthdate, active, _count, _cursor	`$everything`
Appointment	y	y	y	y		_id, patient, practitioner, date, status, appointment-type, _count, _cursor
Encounter	y	y	y	y		_id, patient, practitioner, date, status, class, _count, _cursor
Observation	y	y	y	y		_id, patient, encounter, code, date, status, category, _count, _cursor
MedicationRequest	y	y	y	y		patient, encounter, _count, _cursor
ServiceRequest	y	y		y		patient, encounter, _count, _cursor
Composition	y	y	y	y		_id, patient, type, date, _count, _cursor
DocumentReference	y	y	y	y		patient, type, category, date, _count, _cursor	`$upload`
Practitioner	y	y				name, _count, _offset
Organization	y	y				_id
Subscription	y	y	y	y	y	_id, status, _count, _offset	`$replay`, `$stats`, `$deliveries`
Location	y	y				_id, _count, _offset
HealthcareService	y	y				_id, _count, _offset
PractitionerRole	y	y				_id, practitioner, location, _count, _offset
Schedule	y	y				_id, actor, service-type, _count, _offset
Slot		y				schedule, actor, start, end, _count, _offset
Device	y	y				_id, _count, _offset
CodeSystem	y
ValueSet							`$expand`

Resource Conformance: unspecifiedPatient

Core FHIR Resource
Patient

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	identifier	`token`
SHALL	name	`string`
SHALL	gender	`token`
SHALL	birthdate	`date`
SHALL	active	`token`
SHALL	_count	`number`
SHALL	_cursor	`string`

Extended Operations

Conformance	Operation	Documentation
SHALL	$everything

Resource Conformance: unspecifiedAppointment

Core FHIR Resource
Appointment

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	patient	`reference`
SHALL	practitioner	`reference`
SHALL	date	`date`
SHALL	status	`token`
SHALL	appointment-type	`token`
SHALL	_count	`number`
SHALL	_cursor	`string`

Resource Conformance: unspecifiedEncounter

Core FHIR Resource
Encounter

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	patient	`reference`
SHALL	practitioner	`reference`
SHALL	date	`date`
SHALL	status	`token`
SHALL	class	`token`
SHALL	_count	`number`
SHALL	_cursor	`string`

Resource Conformance: unspecifiedObservation

Core FHIR Resource
Observation

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	patient	`reference`
SHALL	encounter	`reference`
SHALL	code	`token`
SHALL	date	`date`
SHALL	status	`token`
SHALL	category	`token`
SHALL	_count	`number`
SHALL	_cursor	`string`

Resource Conformance: unspecifiedMedicationRequest

Core FHIR Resource
MedicationRequest

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	patient	`reference`
SHALL	encounter	`reference`
SHALL	_count	`number`
SHALL	_cursor	`string`

Resource Conformance: unspecifiedServiceRequest

Core FHIR Resource
ServiceRequest

Reference Policy

Interaction summary

Supports read, search-type, create.

Search Parameters

Conformance	Parameter	Type
SHALL	patient	`reference`
SHALL	encounter	`reference`
SHALL	_count	`number`
SHALL	_cursor	`string`

Resource Conformance: unspecifiedComposition

Core FHIR Resource
Composition

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	patient	`reference`
SHALL	type	`token`
SHALL	date	`date`
SHALL	_count	`number`
SHALL	_cursor	`string`

Resource Conformance: unspecifiedDocumentReference

Core FHIR Resource
DocumentReference

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Search Parameters

Conformance	Parameter	Type
SHALL	patient	`reference`
SHALL	type	`token`
SHALL	category	`token`
SHALL	date	`date`
SHALL	_count	`number`
SHALL	_cursor	`string`

Extended Operations

Conformance	Operation	Documentation
SHALL	$upload

Resource Conformance: unspecifiedPractitioner

Core FHIR Resource
Practitioner

Reference Policy

Interaction summary

Supports read, search-type.

Search Parameters

Conformance	Parameter	Type
SHALL	name	`string`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedOrganization

Core FHIR Resource
Organization

Reference Policy

Interaction summary

Supports read, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	_id	`token`

Resource Conformance: unspecifiedSubscription

Core FHIR Resource
Subscription

Reference Policy

Interaction summary

Supports read, search-type, create, update, delete.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	status	`token`
SHALL	_count	`number`
SHALL	_offset	`number`

Extended Operations

Conformance	Operation	Documentation
SHALL	$replay	Re-enqueue past events in a [from,to] window for outage recovery / backfill (POST; requires system/Subscription.crud).
SHALL	$stats	Per-subscription delivery metrics: delivered/failed/pending/dead, DLQ depth, success rate, latency p50/p95 (GET; requires system/Subscription.rs).
SHALL	$deliveries	Recent delivery-attempt trail, sanitized — never the payload/endpoint/secret (GET; requires system/Subscription.rs).

Resource Conformance: unspecifiedLocation

Core FHIR Resource
Location

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Authorized by the SMART scope system/Appointment.rs. This resource inherits an existing scope — no per-resource system/Location.* scope is minted; requesting one is rejected.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedHealthcareService

Core FHIR Resource
HealthcareService

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Authorized by the SMART scope system/Appointment.rs. This resource inherits an existing scope — no per-resource system/HealthcareService.* scope is minted; requesting one is rejected.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedPractitionerRole

Core FHIR Resource
PractitionerRole

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Authorized by the SMART scope system/Practitioner.rs. This resource inherits an existing scope — no per-resource system/PractitionerRole.* scope is minted; requesting one is rejected.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	practitioner	`reference`
SHALL	location	`reference`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedSchedule

Core FHIR Resource
Schedule

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Authorized by the SMART scope system/Appointment.rs. This resource inherits an existing scope — no per-resource system/Schedule.* scope is minted; requesting one is rejected.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	actor	`reference`
SHALL	service-type	`token`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedSlot

Core FHIR Resource
Slot

Reference Policy

Interaction summary

Supports search-type.

Documentation

Authorized by the SMART scope system/Appointment.rs. This resource inherits an existing scope — no per-resource system/Slot.* scope is minted; requesting one is rejected.

Search Parameters

Conformance	Parameter	Type
SHALL	schedule	`reference`
SHALL	actor	`reference`
SHALL	start	`date`
SHALL	end	`date`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedDevice

Core FHIR Resource
Device

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Authorized by the SMART scope system/Appointment.rs. This resource inherits an existing scope — no per-resource system/Device.* scope is minted; requesting one is rejected.

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	_count	`number`
SHALL	_offset	`number`

Resource Conformance: unspecifiedCodeSystem

Core FHIR Resource
CodeSystem

Reference Policy

Interaction summary

Supports read.

Documentation

Terminology resource. Scope is enforced per CodeSystem id by the handler (e.g. address-source → system/Patient.rs, org-service → system/Appointment.rs).

Resource Conformance: unspecifiedValueSet

Core FHIR Resource
ValueSet

Reference Policy

Interaction summary

Documentation

Terminology operation. Scope is enforced per ValueSet url by the handler (cancellation-reason → system/Appointment.rs, observation-loinc → system/Observation.rs, mx-* → system/Patient.rs).

Extended Operations

Conformance	Operation	Documentation
SHALL	$expand

CapabilityStatement: Huli FHIR R4 Server Capabilities