# FHIR R4 API

The HeyDonto FHIR R4 API provides a complete, standards-compliant implementation of the HL7 FHIR R4 specification for healthcare data interoperability.

## Overview

FHIR (Fast Healthcare Interoperability Resources) is a standard for exchanging healthcare information electronically. Our implementation follows the FHIR R4 specification (version 4.0.1).

## Resource Modules

Select a module from the sidebar to explore its API documentation:

| Module | Description |
|  --- | --- |
| **Foundation** | Core building blocks (Binary, Bundle, CapabilityStatement) |
| **Implementer Support** | StructureDefinition, ImplementationGuide, StructureMap |
| **Security and Privacy** | AuditEvent, Consent, Provenance |
| **Conformance** | CapabilityStatement, OperationDefinition, SearchParameter |
| **Terminology** | ValueSet, CodeSystem, ConceptMap |
| **Exchange** | Bundle, MessageHeader, Subscription |
| **Administration** | Patient, Practitioner, Organization, Location |
| **Clinical** | Condition, Procedure, CarePlan, DocumentReference |
| **Diagnostic** | Observation, DiagnosticReport, ImagingStudy |
| **Medications** | Medication, MedicationRequest, Immunization |
| **Workflow** | Appointment, Schedule, Task, Encounter |
| **Financial** | Account, Claim, Coverage, ExplanationOfBenefit |
| **Clinical Reasoning** | ResearchStudy, Measure, Questionnaire |


## Base URLs

| Environment | URL |
|  --- | --- |
| Production | `https://api.heydonto.com` |
| Staging | `https://api-staging.heydonto.com` |


## Authentication

All endpoints require JWT bearer token authentication. See [Getting Started](/get-started) for details.

## Standard Operations

All FHIR resources support these operations:

| Operation | Endpoint | Description |
|  --- | --- | --- |
| Search | `GET /site/{siteId}/fhir/{resource}` | Search resources |
| Create | `POST /site/{siteId}/fhir/{resource}` | Create a resource |
| Read | `GET /site/{siteId}/fhir/{resource}/{id}` | Read a resource |
| Update | `PUT /site/{siteId}/fhir/{resource}/{id}` | Update a resource |
| Delete | `DELETE /site/{siteId}/fhir/{resource}/{id}` | Delete a resource |
| History | `GET /site/{siteId}/fhir/{resource}/{id}/history` | Get version history |