The Condition resource represents a clinical condition, problem, diagnosis, or other event that requires tracking. All conditions must reference a valid Patient.
Endpoints
Create Condition
Requires admin or practitioner role.
POST /api/fhir/Condition
Authorization: Bearer {token}
Content-Type: application/json
active, recurrence, relapse, inactive, remission, resolved
unconfirmed, provisional, differential, confirmed, refuted, entered-in-error
Condition category (problem-list-item, encounter-diagnosis)
Subjective severity (mild, moderate, severe)
Identification of the condition (ICD-10, SNOMED CT)
Reference to Patient: {"reference": "Patient/{id}"}
When the condition resolved
Additional clinical notes
Example Request
curl -X POST https://api.example.com/api/fhir/Condition \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"resourceType": "Condition",
"clinicalStatus": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active"
}]
},
"verificationStatus": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed"
}]
},
"category": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/condition-category",
"code": "problem-list-item",
"display": "Problem List Item"
}]
}],
"severity": {
"coding": [{
"system": "http://snomed.info/sct",
"code": "24484000",
"display": "Severe"
}]
},
"code": {
"coding": [{
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}]
},
"subject": {
"reference": "Patient/65f1234567890abcdef12345"
},
"onsetDateTime": "2023-01-15",
"note": [{
"text": "Patient reports symptoms began in January 2023"
}]
}'
Response
{
"resourceType": "Condition",
"id": "65f3456789012abcdef34567",
"clinicalStatus": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active"
}]
},
"code": {
"coding": [{
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}]
},
"subject": {
"reference": "Patient/65f1234567890abcdef12345"
},
"onsetDateTime": "2023-01-15"
}
List Conditions
GET /api/fhir/Condition
Authorization: Bearer {token}
Filter by patient: Patient/{id}
Filter by clinical status
Get Condition by ID
GET /api/fhir/Condition/:id
Authorization: Bearer {token}
Update Condition
PUT /api/fhir/Condition/:id
Authorization: Bearer {token}
Content-Type: application/json
Common Condition Categories
| Category | Code | Description |
|---|
| Problem List Item | problem-list-item | Patient’s ongoing conditions |
| Encounter Diagnosis | encounter-diagnosis | Diagnosis during encounter |
Role Permissions
| Role | Create | Read | Update |
|---|
| Admin | ✅ | ✅ | ✅ |
| Practitioner | ✅ | ✅ | ✅ |
| Auditor | ❌ | ✅ | ❌ |