{"id": "de359a25-14d1-4013-ada1-36a264c1b6d0", "key": "social-needs-access", "name": "Social Needs and Access Assessment", "short_name": "Social Needs", "description": "A patient-reported assessment of food, housing, employment, and healthcare access with optional area-level SDI context.", "clinical_domain": "Engagement Intelligence", "assessment_type": "questionnaire", "status": "published", "channels": {"patient": true, "professional": true, "api": true, "sdk": true, "population": true}, "published_version": "1.0", "schema_status": "published", "version": {"number": 1, "label": "1.0", "status": "published"}, "inputs": [{"key": "housing_situation", "label": "Housing situation", "description": "Which best describes your housing today?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "stable", "label": "I have a steady place to live", "numeric_value": null}, {"value": "worried_about_losing", "label": "I am worried about losing my housing", "numeric_value": null}, {"value": "no_steady_place", "label": "I do not have a steady place to live", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "housing_quality_problem", "label": "Housing quality problem", "description": "Does your home have a serious condition that may affect health or safety?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "yes", "label": "Yes", "numeric_value": null}, {"value": "no", "label": "No", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "food_worry", "label": "Food would run out", "description": "In the past 12 months, how often were you worried food would run out before you had money to buy more?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "often", "label": "Often true", "numeric_value": null}, {"value": "sometimes", "label": "Sometimes true", "numeric_value": null}, {"value": "never", "label": "Never true", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "food_not_last", "label": "Food did not last", "description": "In the past 12 months, how often did food not last and you lacked money to buy more?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "often", "label": "Often true", "numeric_value": null}, {"value": "sometimes", "label": "Sometimes true", "numeric_value": null}, {"value": "never", "label": "Never true", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "employment_support", "label": "Employment support", "description": "Would help finding or keeping work be useful?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "help_finding", "label": "Yes, help finding work", "numeric_value": null}, {"value": "help_keeping", "label": "Yes, help keeping work", "numeric_value": null}, {"value": "no_help_needed", "label": "No help needed", "numeric_value": null}, {"value": "not_applicable", "label": "Not applicable", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "usual_source_care", "label": "Usual source of care", "description": "Do you have a place or professional you usually go to for healthcare?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "yes", "label": "Yes", "numeric_value": null}, {"value": "no", "label": "No", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "delayed_care_cost", "label": "Care delayed because of cost", "description": "In the past 12 months, did cost cause you to delay or skip needed care?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "yes", "label": "Yes", "numeric_value": null}, {"value": "no", "label": "No", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "missed_care_transportation", "label": "Care missed because of transportation", "description": "In the past 12 months, did transportation keep you from medical care or medicines?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "yes", "label": "Yes", "numeric_value": null}, {"value": "no", "label": "No", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "difficulty_obtaining_care", "label": "Difficulty obtaining care", "description": "Overall, how much difficulty have you had obtaining needed healthcare?", "data_type": "choice", "units": "", "required": true, "minimum": null, "maximum": null, "population_dimension": true, "options": [{"value": "none", "label": "No difficulty", "numeric_value": null}, {"value": "some", "label": "Some difficulty", "numeric_value": null}, {"value": "prevented", "label": "Difficulty prevented care", "numeric_value": null}, {"value": "prefer_not_to_answer", "label": "Prefer not to answer", "numeric_value": null}]}, {"key": "zip_code", "label": "ZIP code", "description": "Used only for governed area-level context when a matching dataset is available.", "data_type": "string", "units": "", "required": false, "minimum": null, "maximum": null, "population_dimension": true, "options": []}, {"key": "sdi_centile", "label": "SDI centile", "description": "Optional 1-100 centile supplied by an approved SDI enrichment source.", "data_type": "integer", "units": "", "required": false, "minimum": 1.0, "maximum": 100.0, "population_dimension": true, "options": []}, {"key": "sdi_source", "label": "SDI source", "description": "Dataset name/version used to derive the SDI centile.", "data_type": "string", "units": "", "required": false, "minimum": null, "maximum": null, "population_dimension": true, "options": []}], "outputs": [{"key": "social_index_score", "label": "Social Index", "description": "Available-weight adjusted social support context score.", "output_type": "score", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "social_index_category", "label": "Social Index Category", "description": "Social support context band.", "output_type": "category", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "food_security_score", "label": "Food Security Score", "description": "Governed component score.", "output_type": "score", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "healthcare_access_score", "label": "Healthcare Access Score", "description": "Governed component score.", "output_type": "score", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "housing_security_score", "label": "Housing Security Score", "description": "Governed component score.", "output_type": "score", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "employment_security_score", "label": "Employment Security Score", "description": "Governed component score.", "output_type": "score", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "sdi_context_score", "label": "SDI Context Score", "description": "Governed component score.", "output_type": "score", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}, {"key": "sdi_centile", "label": "SDI Centile", "description": "Governed area deprivation centile.", "output_type": "metric", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": false}, {"key": "available_weight_percent", "label": "Available Evidence Weight", "description": "Total available component weight.", "output_type": "metric", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": false}, {"key": "direct_evidence_weight_percent", "label": "Direct Evidence Weight", "description": "Weight supported by patient-reported need domains.", "output_type": "metric", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": false}, {"key": "has_minimum_evidence", "label": "Minimum Evidence Available", "description": "Whether enough direct evidence is available.", "output_type": "metric", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": false}, {"key": "identified_need_keys", "label": "Identified Needs", "description": "Direct need domains requiring confirmation.", "output_type": "metric", "units": "", "patient_visible": false, "professional_visible": true, "population_metric": false}, {"key": "requires_resource_follow_up", "label": "Resource Follow-up", "description": "Whether a direct response indicates possible resource follow-up.", "output_type": "flag", "units": "", "patient_visible": true, "professional_visible": true, "population_metric": true}], "endpoints": {"execute": "/assessment-studio/api/v1/assessments/social-needs-access/execute/"}}