Record SDOH Observation and Condition resources with Gravity Project social-determinant categories in FHIR

In-depth guide

Steps

1. Identify the appropriate SDOH domain (e.g., food insecurity, housing instability, transportation insecurity) and select the matching code from the SDOHCC ValueSet SDOH Category
2. Create an SDOHCCObservationScreeningResponse resource: set Observation.category to 'social-history' and the domain-specific Gravity category; populate Observation.code from the Gravity-curated LOINC panel code for the screening instrument used
3. Set Observation.value[x] using the domain-specific Gravity answer value set (e.g., SDOHCC ValueSet for Food Insecurity) corresponding to the screening question answered
4. If the screening response indicates a confirmed social risk, create an SDOHCCCondition resource: set Condition.category to 'health-concern', populate Condition.code from the Gravity SNOMED CT or ICD-10-CM value set for that domain, and link it to the triggering Observation via Condition.evidence.detail
5. Optionally create an SDOHCCObservationAssessment for clinician-assessed (non-survey) social risk findings, which uses the same category pattern but does not require a panel LOINC code
6. Submit both resources to the FHIR server; verify they can be retrieved by searching Observation?category=sdoh and Condition?category=health-concern with appropriate patient context