Social History API Guide

Each social history type has a specific set of available status options.

Defined below are each of the types along with their associated set of status options as well as their definition and related snomed code. The status value is the value to use in the API post call. The definition and snomed code is provided for reference.

alcohol: [
    {
      snomed_code: "219006",
      status: "Current drinker of alcohol",
      definition: "Currently consumes alcohol."
    },
    {
      snomed_code: "160577002",
      status: "Heavy drinker - 7-9u/day",
      definition: "Consumes 7-9 units of alcohol per day."
    },
    {
      snomed_code: "160575005",
      status: "Light drinker - 1-2u/day",
      definition: "Consumes 1-2 units of alcohol per day."
    },
    {
      snomed_code: "160576006",
      status: "Moderate drinker - 3-6u/day",
      definition: "Consumes 3-6 units of alcohol per day."
    },
    {
      snomed_code: "266917007",
      status: "Trivial drinker - <1u/day",
      definition: "Consumes less than 1 unit of alcohol per day."
    },
    {
      snomed_code: "160578007",
      status: "Very heavy drinker - greater than 9 units/day",
      definition: "Consumes more than 9 units of alcohol per day."
    },
    {
      snomed_code: "28127009",
      status: "Social drinker",
      definition: "Consumes alcohol in social settings."
    },
    {
      snomed_code: "105542008",
      status: "Non-Drinker",
      definition: "Does not consume alcohol."
    }
  ],
  tobacco: [
    {
      snomed_code: "702979003",
      status: "Never used tobacco",
      definition: "Has never used tobacco."
    },
    {
      snomed_code: "81703003",
      status: "Chews tobacco",
      definition: "Currently chews tobacco."
    },
    {
      snomed_code: "110483000",
      status: "Tobacco user",
      definition: "Currently uses tobacco."
    },
    {
      snomed_code: "702975009",
      status: "Ex-tobacco user",
      definition: "Previously used tobacco."
    }
  ],
  smoking: [
    {
      snomed_code: "8392000",
      status: "Non-smoker",
      definition: "Does not smoke."
    },
    {
      snomed_code: "77176002",
      status: "Smoker",
      definition: "Currently smokes."
    },
    {
      snomed_code: "160617001",
      status: "Stopped smoking",
      definition: "Has stopped smoking."
    },
    {
      snomed_code: "394872000",
      status: "Ready to stop smoking",
      definition: "Is ready to stop smoking."
    },
    {
      snomed_code: "160616005",
      status: "Trying to give up smoking",
      definition: "Is trying to give up smoking."
    },
    {
      snomed_code: "446172000",
      status: "Failed attempt to stop smoking",
      definition: "Had a failed attempt to stop smoking."
    }
  ],
  exercise: [
    {
      snomed_code: "228448000",
      status: "Exercises regularly",
      definition: "Exercises on a regular basis."
    },
    {
      snomed_code: "228446001",
      status: "Gets little exercise",
      definition: "Engages in little physical activity."
    },
    {
      snomed_code: "228445002",
      status: "Gets no exercise",
      definition: "Does not engage in any physical activity."
    },
    {
      snomed_code: "102533007",
      status: "Excessive exercise",
      definition: "Engages in excessive physical activity."
    }
  ],
  employment: [
    {
      snomed_code: "224363007",
      status: "Employed",
      definition: "Currently employed."
    },
    {
      snomed_code: "73438004",
      status: "Unemployed",
      definition: "Currently unemployed."
    },
    {
      snomed_code: "105493001",
      status: "Retired",
      definition: "Retired from work."
    },
    {
      snomed_code: "224456008",
      status: "On leave from work",
      definition: "Currently on leave from work."
    },
    {
      snomed_code: "224372004",
      status: "Does voluntary work",
      definition: "Engages in voluntary work."
    },
    {
      snomed_code: "440337002",
      status: "Temporarily unable to work due to medical condition",
      definition: "Temporarily unable to work due to a medical condition."
    },
    {
      snomed_code: "440584001",
      status: "Permanently unable to work due to medical condition",
      definition: "Permanently unable to work due to a medical condition."
    }
  ],
  substanceUse: [
    {
      snomed_code: "361055000",
      status: "Misuses drugs",
      definition: "Currently misuses drugs."
    },
    {
      snomed_code: "712542001",
      status: "Abstinent from drug misuse (used in the past)",
      definition: "Abstinent from drug misuse after having used in the past."
    },
    {
      snomed_code: "44870007",
      status: "Misused drugs in the past",
      definition: "Has misused drugs in the past."
    },
    {
      snomed_code: "1290542000",
      status: "Unintentional misuse of medication",
      definition: "Has unintentionally misused medication."
    },
    {
      snomed_code: "712542001",
      status: "Abstinent from drug misuse",
      definition: "Never misused substances"
    }
  ]