Get the medical health profile of the user. This includes observations about the user such as demographics, smoking status, alcohol use, etc.

Return a user’s medical profile:
GET https://api.humanapi.co/v1/human/medical/profile

# Returns a json object as profile:
{
  "id": "54e344fa79192a2e4993dfda",
  "updatedAt": "2015-02-13T21:27:42.078Z",
  "createdAt": "2015-02-13T21:27:42.078Z",
  "demographics": {
    "address": {
      "city": "Vulcun City",
      "country": "USA",
      "state": "CA",
      "street": ["1 Milky way"],
      "zip": "94025"
    },
    "ethnicity": "Non Hispanic",
    "gender": "male",
    "language": "ENG",
    "maritalStatus": "married",
    "race": "White/Caucasian",
    "dob": "03-05-1985",
    "name": {
      "family": "Forrest",
      "given": ["Maxwell"]
    },
    "ethnicityCodes": [
      {
        "code" : "2186-5",
        "codeSystemName" : "RACE&ETHNICITY-CDC"
        "inferred" : true
      },
      {
        "code" : "2131-1",
        "codeSystemName" : "RACE&ETHNICITY-CDC",
        "inferred" : true
      },
      {
        "code" : "413655005",
        "codeSystemName" : "SNOMED-CT",
        "inferred" : true
      },
      {
        "code" : "413774005",
        "codeSystemName" : "SNOMED-CT",
        "inferred" : true
      }
    ],
    "maritalStatusCodes": [
      {
        "code" : "87915002",
        "codeSystemName" : "SNOMED-CT",
        "inferred" : true
      }
    ],
    "genderCodes": [
      {
        "code" : "703117000",
        "codeSystemName" : "SNOMED-CT",
        "inferred" : true
      }
    ]
  },
  "alcohol": {
    "use": "yes",
    "codes": [
      {
        "code" : "704197006",
        "codeSystemName" : "SNOMED-CT",
        "inferred" : true
      }
    ]
  },
  "smoking": {
    "status": "Never smoker",
    "codes": [
      {
        "code" : "266919005",
        "codeSystemName" : "SNOMED-CT",
        "inferred" : true
      }
    ]
  }
}
# Get user's medical profile
curl -H "Authorization: Bearer demo" "https://api.humanapi.co/v1/human/medical/profile"

📘

HTTP response 404

The profile endpoint may return a 404 response when there is no profile data to return.

Response Properties

PropertyTypeDescription
idStringThe id of the resource
sourceStringThe name of the originating service
updatedAtDateThe time the record was updated on the Human API server
createdAtDateThe time the record was created on the Human API server
demographicsObject(optional) See demographics
alcoholObject(optional) The user’s alcohol usage
smokingObject(optional) The user’s smoking habits

Demographics Object

PropertyTypeDescription
addressObjectSee address object
dobString(optional) The user’s date of birth e.g. "04/21/1965"
ethnicityString(optional) The ethnicity of the user e.g. "Not Hispanic of Latino"
genderString(optional) The user’s gender e.g. "male"
languageString(optional) The user’s primary language e.g. "eng"
maritalStatusString(optional) The user’s marital status (eg: “married”, “single”)
nameObject(optional) See name object
raceString(optional) The user’s race e.g. "White"
ethnicityCodesArray[Object](optional) CDC Race & Ethnicity and SNOMED CT Ethnicity codes: See codes
maritalStatusCodesString(optional) SNOMED CT Marital status codes: see codes object
genderCodesString(optional) SNOMED CT Gender codes: See codes

Address Object

PropertyTypeDescription
cityString(optional) City of address e.g. "SAN FRANCISCO"
countryString(optional) Country of address e.g. "US"
stateString(optional) State of address e.g. "CA"
streetArray[String](optional) Street of address e.g. ["156 22ND AVE NW"]
zipString(optional) Zip of address e.g. "94123"

Alcohol Object

PropertyTypeDescription
useString(optional) The user’s alcohol usage e.g. “yes”, “no”
codesArray[Object](optional) SNOMED CT Alcohol use codes: See codes

Smoking

PropertyTypeDescription
statusStringThe user’s smoking status (e.g. “Never Smoker”)
codesArray[Object]SNOMED CT Smoking use codes: See codes