Procedure

The Procedure resource documents a healthcare intervention performed on a patient — surgeries, therapies, diagnostic procedures, and other medical services.

API convention: patient, encounter, and location references are sent as flat string id fields (subjectId, encounterId, locationId). Performer references use the standard FHIR reference shape. All resource ids are raw UUIDs (v4).

Creating a Procedure

curl -X POST https://api.esus.health/fhir/Procedure \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/fhir+json" \
  -d '{
    "status": "completed",
    "subjectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "encounterId": "c1a2e3d4-5b6f-7890-abcd-ef1234567890",
    "code": {
      "coding": [{
        "system": "http://snomed.info/sct",
        "code": "80146002",
        "display": "Appendectomy"
      }]
    },
    "performedDateTime": "2026-04-21T11:30:00Z"
  }'

Procedure Statuses

Status	Meaning
`preparation`	In preparation
`in-progress`	Currently being performed
`not-done`	Procedure not performed
`on-hold`	Temporarily suspended
`stopped`	Procedure stopped
`completed`	Successfully completed
`entered-in-error`	Erroneous record
`unknown`	Status cannot be determined

If status is not-done, statusReason (a CodeableConcept) explains why.

Common Fields

Field	Description
`subjectId`	The patient (UUID)
`encounterId`	The visit during which it occurred (UUID)
`locationId`	Where it was performed (UUID)
`performer[]`	Who performed the procedure (FHIR reference shape)
`outcome`	What happened (success, complication)
`complication`	Any complication that occurred

Linking to a Practitioner

{
  "performer": [
    {
      "actor": {
        "reference": "Practitioner/a7b1c2d3-e4f5-6789-abcd-ef0123456789",
        "display": "Dr. John Martinez"
      },
      "function": {
        "coding": [{ "code": "SA", "display": "Surgeon" }]
      }
    }
  ]
}