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.