Skip to main content

Procedure

Overview​

The Procedure resource represents actions performed on or for a patient, including physical interventions like operations, less invasive procedures, long-term services, counseling, or therapeutic interventions.

Resource Schema​

Key fields in the Procedure resource:

{
  "resourceType": "Procedure",
  "id": "example-procedure-123",
  "status": "completed",
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "80146002",
        "display": "Appendectomy"
      }
    ]
  },
  "subject": {
    "reference": "Patient/123456"
  },
  "performedDateTime": "2023-07-15T14:30:00Z",
  "performer": [
    {
      "actor": {
        "reference": "Practitioner/789"
      }
    }
  ],
  "location": {
    "reference": "Location/456"
  },
  "reasonCode": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "74400008",
          "display": "Appendicitis"
        }
      ]
    }
  ]
}

Operations​

The Procedure resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / SolutionReadSearch
GEHRIMED✅✅
myAvatar✅✅
myEvolv✅✅
myUnity✅✅
TheraOffice✅✅

Read​

Retrieves a specific Procedure resource by ID.

HTTP Method: GET
URL: /Procedure/{id}

Examples​

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Procedure/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Retrieves Procedure resources matching specified criteria.

HTTP Method: GET or POST
URL: /Procedure or /Procedure/_search

Search Parameters​

Patient-based Search:

ParameterTypeRequiredDescriptionExample
patientreferenceYesREQUIRED Search by subject - a patientpatient=value
datedateNoWhen the procedure was performeddate=value
pagestringNoZero-based page indexpage=value
performerreferenceNoThe reference to the practitionerperformer=value
_revincludespecialNoInclude Provenance resource(s) that reference the matched search results. Allowed: "Provenance:target"_revinclude=value

ID-based Search:

ParameterTypeRequiredDescriptionExample
datedateNoWhen the procedure was performeddate=value
pagestringNoZero-based page indexpage=value
performerreferenceNoThe reference to the practitionerperformer=value
_revincludespecialNoInclude Provenance resource(s) that reference the matched search results. Allowed: "Provenance:target"_revinclude=value

Examples​

POST Method (Recommended)​
Search by Patient
curl -X POST https://fhir.netsmartcloud.com/uscore/v1/Procedure/_search \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d "patient=Patient/123"
GET Method​
Search by Patient
curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Procedure?patient=Patient/123 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Integration Patterns​

Common Workflows​

  1. Procedure History - Retrieve all procedures performed on a patient
  2. Recent Procedures - Search by date range for recent interventions
  3. Surgical History - Filter procedures by type or category

Relationships to Other Resources​

The Procedure resource relates to:

  • Patient - Subject of the procedure
  • Practitioner - Who performed the procedure
  • Encounter - Healthcare encounter when procedure was performed
  • Condition - Conditions that may have indicated the procedure
  • Location - Where the procedure was performed

Error Handling​

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles​

Profiles supported by this resource (as defined in the CapabilityStatement):