Overview of the BaseHealth Application Programming Interface


BaseHealth API offers the following services:


Curated Content

Disease analysis results include the following parameters:

  • Associated Genes/Variants
  • Risk Factors
  • Actions that could reduce risk
  • Disease statistics and prevalence

The URL for Curated Content requests has the following pattern https://api.basehealth.com/Genophen/api/v1/{diseaseKey}, where {diseaseKey} is the BaseHealth Key for a disease. There are no parameters but the call will require your API access key to be provided in the header. Please see curated content service documentation for details of all the available requests.


Anonymous Assessment

Anonymous Assessment results include the following parameters based on our comprehensive assessment engine:

  • Risk Level at 65
  • Current Odds for the disease
  • Achievable Odds for the disease
  • List of risk factors and the odds associated with each risk factor

The URL for Anonymous Assessment requests has the following the pattern: https://api.basehealth.com/Genophen/api/v1/diseases/{diseaseKey}, where {diseaseKey} is the BaseHealth Key for a disease. These requests require your API access key to be provided in the header and also a variable set of input parameters in a JSON message depending on the the disease. Only gender and year of birth parameters are mandatory, all other parameters are optional. The more parameters you have values for, the more accurate the assessment is likely to be. Please see anonymous assessment service documentation for details of all the available requests and the parameter values that they require.


Drug Response

Drug responses for genetic variations include the following parameters:

  • Genotype effects (e.g. Average, Increased, Decreased)
  • Affected attribute by genotype (e.g. Drug effect in lowering blood pressure)
  • The number of variations that contribute to this effect
  • The list of variations that contribute to this effect
  • The ethnicity on which this effect is found

The URL for Drug Response requests has the following pattern https://api.basehealth.com/Genophen/api/v1/geneticAnalysis/pharmacogenomics/{drugKey}, where {drugKey} is the BaseHealth Key for a drug. These requests require your API access key to be provided in the header and also the following input parameters:

  • Gender
  • Ethnicity
  • List of SNP Ids and associated genotypes

Please see drug response service documentation for details of all the available requests and the parameter values that they require.


Food Response

Food responses for gentic variations cover the following parameters:

  • Genotype effects (e.g. Average, Increased, Decreased)
  • Affected attribute by genotype (e.g. Vitamin D Levels)
  • The number of variations that contribute to this effect
  • The list of variations that contribute to this effect
  • The ethnicity on which this effect is found

The URL for Food Response requests has the following pattern https://api.basehealth.com/Genophen/api/v1/geneticAnalysis/nutrigenomics/{nutrientKey}, where {nutrientKey} is the BaseHealth Key for a nutrient. These requests require your API access key to be provided in the header and also the following input parameters:

  • Gender
  • Ethnicity
  • List of SNP Ids and associated genotypes

Please see food response service documentation for details of all the available requests and the parameter values that they require.


Personalized Assessment

Personalized Assessment information is about members that already exist on BaseHealth platform. This is different from all the above services, these requests need not only the API access key but also a auth_token obtained from the BaseHealth platform after the member authorizes the use of his/her data. Please see Oauth documentation to learn how to get member authorization, see personalized assessments service documentation for details of all the available requests and the parameter values that they require.