Skip to main content

GET Results

Request the results for a patient that is associated with a LetsGetChecked test kit.

Request

Endpoint

Path parameters

Response

Sample response

Request

Endpoint

GET {clientId}/api/v1/results/{barcode}?alphaCode={alphaCode}

Path parameters

ParameterDescriptionTypeRequired/Optional
Barcode / numerical codeFormatted as LGC-0000-0000-0000, where 0 indicates any digit.stringRequired
alphaCodeFormatted as AAAAAA, where A indicates any uppercase letter from A to Z.stringRequired

Response

The sample response is a single JSON object that contains the following fields:

PropertyDescriptionType
testResultsThe test kit results for the patient.list of objects(testResults)
biomarkerNameThe name of the biomarker that is tested. A biomarker is a biological molecule found in blood, other body fluids, or tissues that is a sign of a normal or abnormal process, or of a condition or disease.string
kindThe values can be Qualitative, Quantitative, or Genetic.string
descriptorA brief description of the test result. The following descriptors are possible for results with a quantitativeValue:
  • Normal
  • Low
  • High
  • Borderline

The following descriptors are possible for results with a qualitativeValue

  • Reactive
  • Detected
  • Positive
  • Isolated
  • NonReactive
  • NotDetected
  • Negative
  • NotIsolated

string
headlineA brief summary of the test result.string
descriptionA detailed description of the test results, reported by the LetsGetChecked lab.string
testCodeAn identifier for each biomarker in the LetsGetChecked system. The testCode for each biomarker is an internal LetsGetChecked laboratory code.string
patientIdentificationInformation that identifies the patient.The patient identification contains the following information:
  • resellerId, string
  • patientResellerPatientId, string
  • firstName, string
  • middleName, string
  • lastName, string
  • dob, string
  • phone, string
  • gender, the values can be either Male or Female
  • address, string
Tip: LetsGetChecked provides the resellerId. There is one resellerId per client. The patientResellerPatientId is for internal LetsGetChecked use and the value returned is always null.
clientOrderIdThe Client Order ID is a unique code associated with a client.string
timestampThe date and time at which the results are available.datetime
QuantitativeValueObject that contains the numerical result of the test. Certain results can be represented with less than or greater than symbols (< or >) depending on thresholds for measurable ranges for certain biomarkers.The quantitative value contains the following information:
  • value, string
  • unit, string
  • minimum, string
  • maximum, string
GeneticValueThe genetic value which can be represented as:
  • A genotype, describing the genetic characteristics of the test result.
  • A phenotype, describing the physical characteristics of the test results.
The genetic value contains the following information:
  • gene, string
  • genotype, string
  • phenotype, string
  • phenotypeImageKey, string
  • phenotypeDescription, string
QualitativeValueA description of the test result.

Note: Results can have a Cancelled value if patient information is incomplete on the bio bag that is returned to the LetsGetChecked lab.

The qualitative value is an enumerated property that can return one of the following values:
  • None
  • Testing
  • TestNotRequired
  • NotDetected
  • NonReactive
  • Negative
  • NotIsolated
  • Detected
  • Positive
  • Reactive
  • Isolated
  • BorderlineReactive
  • Hemolyzed
  • InvalidSpecimen
  • AgedSpecimen
  • CompromisedSpecimen
  • NoSpecimenReceived
  • InsufficientSpecimen
  • LabError
  • Clotted
  • Cancelled
  • NotAvailable
  • Inconclusive
  • Rejected
  • IncorrectTube
  • IncorrectVolume
  • Unmeasurable
  • TimeError
  • NoValueCalculated
  • InsufficientSerum
  • DispatchError
  • CollectionError
  • InvalidOrder
  • SampleIDIssue
  • Uncontactable
  • Icteric
  • Lipemic
  • Invalid

Sample response

{
"testResults":[
{
"biomarkerName:"string",
"kind":"Qualitative"|"Quantitative"|"Genetic",
"descriptor":"string",
"headline":"string",
"description":"string",
"testCode":"string",
"quantitativeValue":{QuantitativeValue},
"geneticValue":{GeneticValue},
"qualitativeValue":"string"
}],
"patientIdentification":
{
"firstName":"string",
"lastName":"string",
"dob":"string",
"gender":"Male"|"Female"
},
"clientOrderId":"string",
"timeStamp":"datetime"
}

"QuantitativeValue":{
"value":"string",
"unit":"string",
"minimum":"string",
"maximum":"string”
}

GeneticValue:{
"gene":"string",
"genotype":"string",
"phenotypeImageKey":"string",
"phenotypeDescription":"string"
}

enum QualitativeValue {
None,
Cancelled,
Test Not Required,
Testing,
NotAvailable,
BorderlineReactive,
Reactive,
Detected,
Positive,
NotDetected,
NoSpecimenReceived,
InsufficientSpecimen,
Negative,
NonReactive,
Isolated,
NotIsolated
AgedSpecimen,
Haemolyzed,
Inconclusive,
InvalidSpecimen,
LabError,
CompromisedSpecimen,
Clotted,
Rejected,
IncorrectTube,
IncorrectVolume,
Unmeasurable,
TimeError,
NoValueCalculated,
InsufficientSerum,
DispatchError,
CollectionError,
InvalidOrder,
SampleIDIssue,
Uncontactable,
Icteric,
Lipemic,
Invalid
}

Example 1: Diabetes Test - Normal Result

{
"testResults":[
{
"biomarkerName":"HbA1c",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your HbA1c test result has been returned as NORMAL.",
"description":"A normal test result can mean that your average blood sugar level over the last 3 months was within either the normal (<5.7%) or prediabetic (5.7-6.4%) reference range. These ranges are based on the CDC (US) and HSE (Irish) guidelines. Please note prediabetic reference ranges for UK residents are between 6.0% and 6.4%. Results within the prediabetic range can mean that you could be at higher risk for developing diabetes. If you are pregnant it is important to talk to your healthcare provider. If you have an existing diagnosis of diabetes, your HbA1c is within the normal range. The target for people with diabetes is often 7% or less. It is important to know that targets can vary based on your medical history. Your healthcare provider will be able to advise on the best target level for you. This test is not a replacement for regular blood sugar testing at home. Even though this result is normal, if you are experiencing symptoms please share these results with your healthcare provider.",
"testCode":"0111",
"quantitativeValue":{
"value":"4",
"unit":"%",
"lowerBound":0.0,
"upperBound":6.5
},
"geneticValue":null,
"qualitativeValue":null
}
],
"patientIdentification":{
"resellerId":"00000000-0000-0000-0000-000000000000",
"patientResellerPatientId":null,
"firstName":"John",
"middleName":null,
"lastName":"Smith",
"dob":"1990-2-28",
"phone":null,
"gender":"Male",
"address":null
},
"clientOrderId":"731042",
"timeStamp":"2022-01-21T12:10:09.396Z"
}

Example 2: Diabetes and Heart Test - Normal Result

{
"testResults":[
{
"biomarkerName":"Cholesterol",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your Cholesterol test result has been returned as NORMAL.",
"description":"Your total cholesterol test result is normal. This means that your total cholesterol test result was within the normal range. The total cholesterol level is a combination of both LDL (bad) and HDL (good) cholesterol. It is important to consider the levels of LDL and HDL cholesterol individually when deciding on the best steps to take to improve your health. Ways to maintain desirable cholesterol levels include regular exercise, avoiding excess sugar, and eating healthier unsaturated fats such as those found in fish and plant oils.",
"testCode":"0042",
"quantitativeValue":{
"value":"180",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":200.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"HDL (high density lipoprotein)",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your HDL (high density lipoprotein) test result has been returned as NORMAL.",
"description":"Your high-density lipoprotein (HDL) test result was normal. This means that your HDL levels were within the normal range. Maintaining optimal levels of HDL (good) cholesterol is important in order to lower your risk of developing heart disease and cardiovascular complications such as heart attack and stroke. Ways to maintain optimal HDL cholesterol levels include regular exercise, not smoking, and eating a healthy diet containing “good fats” such as those found in oily fish and plant oils.",
"testCode":"0050",
"quantitativeValue":{
"value":"48",
"unit":"mg/dL",
"lowerBound":40.0,
"upperBound":59.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"High-Density Lipoprotein (HDL) % of Total Cholesterol",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your High-Density Lipoprotein (HDL) % of Total Cholesterol test result has been returned as NORMAL.",
"description":"Your High-Density Lipoprotein (HDL) % of Total Cholesterol test result was normal. This means that your HDL (high-density lipoprotein) % of total cholesterol was within the normal range. Total cholesterol levels are a combination of HDL (good), LDL (bad) cholesterol, and triglycerides. This result indicates that you have a normal balance of HDL cholesterol when compared to your total cholesterol levels. When deciding on the next steps to take, this result should be viewed in combination with your other cholesterol test results. Normal levels of HDL % of total cholesterol can be maintained by exercising regularly, not smoking, and eating a healthy diet containing “good fats” such as those found in oily fish and plant oils.",
"testCode":"0049",
"quantitativeValue":{
"value":"2",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":5.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"LDL (low density lipoprotein)",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your LDL (low density lipoprotein) test result has been returned as NORMAL.",
"description":"Your LDL (low-density lipoprotein) test result was normal. This means that your LDL (low-density lipoprotein) test result was within the normal range. Maintaining normal levels of LDL (bad) cholesterol is important in order to lower your risk of developing heart disease and cardiovascular complications such as heart attack and stroke. Ways to maintain optimal LDL cholesterol levels include regular exercise, not smoking, and eating a healthy diet containing “good fats” such as those found in oily fish and plant oils. It may also help to avoid eating too much-saturated fat, this is contained in red meat and full-fat dairy products. You may have different target levels for LDL cholesterol if you have a condition that puts you at a higher than average risk for heart disease. If this applies to you please speak to your healthcare provider about your LDL targets.",
"testCode":"0052",
"quantitativeValue":{
"value":"120",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":130.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"Total Triglycerides",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your Total Triglycerides test result has been returned as NORMAL.",
"description":"This means that your total triglycerides were within the normal range. Your body converts any calories it doesn't need into triglycerides and this is stored as fat. Maintaining triglyceride levels within the desirable range is important in order to reduce your risk of developing heart disease and other cardiovascular complications. Ways to maintain desirable triglyceride levels include regular exercise, avoiding excess sugar, and eating healthier unsaturated fats such as those found in fish and plant oils.",
"testCode":"0058",
"quantitativeValue":{
"value":"140",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":150.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"HbA1c",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your HbA1c test result has been returned as NORMAL.",
"description":"A normal test result can mean that your average blood sugar level over the last 3 months was within either the normal (<5.7%) or prediabetic (5.7-6.4%) reference range. These ranges are based on the CDC (US) and HSE (Irish) guidelines. Please note prediabetic reference ranges for UK residents are between 6.0% and 6.4%. Results within the prediabetic range can mean that you could be at higher risk for developing diabetes. If you are pregnant it is important to talk to your healthcare provider. If you have an existing diagnosis of diabetes, your HbA1c is within the normal range. The target for people with diabetes is often 7% or less. It is important to know that targets can vary based on your medical history. Your healthcare provider will be able to advise on the best target level for you. This test is not a replacement for regular blood sugar testing at home. Even though this result is normal, if you are experiencing symptoms please share these results with your healthcare provider.",
"testCode":"0111",
"quantitativeValue":{
"value":"4",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":7.0
},
"geneticValue":null,
"qualitativeValue":null
}
],
"patientIdentification":{
"resellerId":"00000000-0000-0000-0000-000000000000",
"patientResellerPatientId":null,
"firstName":"John",
"middleName":null,
"lastName":"Smith",
"dob":"1990-2-28",
"phone":null,
"gender":"Male",
"address":null
},
"clientOrderId":"0e788588-d39d-40b1-a590-67ec250a2853",
"timeStamp":"2022-01-07T14:30:46.03Z"
}

Example 3: Positive COVID-19 Result

{
"testResults":[
{
"biomarkerName":"Coronavirus COVID-19",
"kind":"Qualitative",
"descriptor":"Positive",
"headline":"Your Coronavirus COVID-19 test result has been returned as POSITIVE.",
"description":"This is a positive coronavirus test result. This means you have tested positive for the form of coronavirus that causes COVID-19. You should tell your healthcare provider about this result. You will need to stay in self-isolation. This means you will need to stay at home and stay away from other people in your home. You will also need to follow the advice provided by your doctor and local health department. You should watch for symptoms of COVID-19. These include fever, cough or breathing difficulties. Most people who get coronavirus will not get very bad symptoms. If you feel very unwell or if you find it hard to breathe you should call your healthcare provider right away. If it's an emergency, call the emergency services.",
"testCode":"0211",
"quantitativeValue":null,
"geneticValue":null,
"qualitativeValue":"Positive"
}
],
"patientIdentification":{
"resellerId":"00000000-0000-0000-0000-000000000000",
"patientResellerPatientId":null,
"firstName":"John",
"middleName":null,
"lastName":"Smith",
"dob":"1990-2-28",
"phone":null,
"gender":"Male",
"address":null
},
"clientOrderId":"0e788588-d39d-40b1-a590-67ec250a2854",
"timeStamp":"2022-01-07T11:59:48.058Z"
}

Example 4: Diabetes & Heart Result

{
"testResults":[
{
"biomarkerName":"Cholesterol",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your Cholesterol test result has been returned as NORMAL.",
"description":"Your total cholesterol test result is normal. This means that your total cholesterol test result was within the normal range. The total cholesterol level is a combination of both LDL (bad) and HDL (good) cholesterol. It is important to consider the levels of LDL and HDL cholesterol individually when deciding on the best steps to take to improve your health. Ways to maintain desirable cholesterol levels include regular exercise, avoiding excess sugar, and eating healthier unsaturated fats such as those found in fish and plant oils.",
"testCode":"0042",
"quantitativeValue":{
"value":"180",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":200.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"HDL (high density lipoprotein)",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your HDL (high density lipoprotein) test result has been returned as NORMAL.",
"description":"Your high-density lipoprotein (HDL) test result was normal. This means that your HDL levels were within the normal range. Maintaining optimal levels of HDL (good) cholesterol is important in order to lower your risk of developing heart disease and cardiovascular complications such as heart attack and stroke. Ways to maintain optimal HDL cholesterol levels include regular exercise, not smoking, and eating a healthy diet containing “good fats” such as those found in oily fish and plant oils.",
"testCode":"0050",
"quantitativeValue":{
"value":"48",
"unit":"mg/dL",
"lowerBound":40.0,
"upperBound":59.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"High-Density Lipoprotein (HDL) % of Total Cholesterol",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your High-Density Lipoprotein (HDL) % of Total Cholesterol test result has been returned as NORMAL.",
"description":"Your High-Density Lipoprotein (HDL) % of Total Cholesterol test result was normal. This means that your HDL (high-density lipoprotein) % of total cholesterol was within the normal range. Total cholesterol levels are a combination of HDL (good), LDL (bad) cholesterol, and triglycerides. This result indicates that you have a normal balance of HDL cholesterol when compared to your total cholesterol levels. When deciding on the next steps to take, this result should be viewed in combination with your other cholesterol test results. Normal levels of HDL % of total cholesterol can be maintained by exercising regularly, not smoking, and eating a healthy diet containing “good fats” such as those found in oily fish and plant oils.",
"testCode":"0049",
"quantitativeValue":{
"value":"2",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":5.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"LDL (low density lipoprotein)",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your LDL (low density lipoprotein) test result has been returned as NORMAL.",
"description":"Your LDL (low-density lipoprotein) test result was normal. This means that your LDL (low-density lipoprotein) test result was within the normal range. Maintaining normal levels of LDL (bad) cholesterol is important in order to lower your risk of developing heart disease and cardiovascular complications such as heart attack and stroke. Ways to maintain optimal LDL cholesterol levels include regular exercise, not smoking, and eating a healthy diet containing “good fats” such as those found in oily fish and plant oils. It may also help to avoid eating too much-saturated fat, this is contained in red meat and full-fat dairy products. You may have different target levels for LDL cholesterol if you have a condition that puts you at a higher than average risk for heart disease. If this applies to you please speak to your healthcare provider about your LDL targets.",
"testCode":"0052",
"quantitativeValue":{
"value":"120",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":130.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"Total Triglycerides",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your Total Triglycerides test result has been returned as NORMAL.",
"description":"This means that your total triglycerides were within the normal range. Your body converts any calories it doesn't need into triglycerides and this is stored as fat. Maintaining triglyceride levels within the desirable range is important in order to reduce your risk of developing heart disease and other cardiovascular complications. Ways to maintain desirable triglyceride levels include regular exercise, avoiding excess sugar, and eating healthier unsaturated fats such as those found in fish and plant oils.",
"testCode":"0058",
"quantitativeValue":{
"value":"140",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":150.0
},
"geneticValue":null,
"qualitativeValue":null
},
{
"biomarkerName":"HbA1c",
"kind":"Quantitative",
"descriptor":"Normal",
"headline":"Your HbA1c test result has been returned as NORMAL.",
"description":"A normal test result can mean that your average blood sugar level over the last 3 months was within either the normal (<5.7%) or prediabetic (5.7-6.4%) reference range. These ranges are based on the CDC (US) and HSE (Irish) guidelines. Please note prediabetic reference ranges for UK residents are between 6.0% and 6.4%. Results within the prediabetic range can mean that you could be at higher risk for developing diabetes. If you are pregnant it is important to talk to your healthcare provider. If you have an existing diagnosis of diabetes, your HbA1c is within the normal range. The target for people with diabetes is often 7% or less. It is important to know that targets can vary based on your medical history. Your healthcare provider will be able to advise on the best target level for you. This test is not a replacement for regular blood sugar testing at home. Even though this result is normal, if you are experiencing symptoms please share these results with your healthcare provider.",
"testCode":"0111",
"quantitativeValue":{
"value":"4",
"unit":"mg/dL",
"lowerBound":0.0,
"upperBound":7.0
},
"geneticValue":null,
"qualitativeValue":null
}
],
"patientIdentification":{
"resellerId":"00000000-0000-0000-0000-000000000000",
"patientResellerPatientId":null,
"firstName":"John",
"middleName":null,
"lastName":"Smith",
"dob":"1990-2-28",
"phone":null,
"gender":"Male",
"address":null
},
"clientOrderId":"0e788588-d39d-40b1-a590-67ec250a2853",
"timeStamp":"2022-01-07T14:30:46.03Z"
}