LinAge Calculator API

Calculate biological age using our LinAge API. This endpoint provides biological age assessments using advanced algorithms based on comprehensive biometric markers, offering insights into health status by comparing biological age to chronological age.

For practical use cases, read more about our LinAge Calculator. For clinical studies and scientific details, see the LinAge scientific foundation. Or read about our entire Biometric Calculator suite.

API Endpoint

Base URL

https://api.lincolncannon.co/biometric/calculate

Method

• POST - All calculations are performed via POST requests

Headers

Request Parameters

Parameter Notes

• Numeric Validation: All biometric values must be finite numbers. Most must be positive; CRP may be negative.
• Diagnosis Flags: All comorbidity diagnosis flags are optional and default to false if not provided.
• Sex: Defaults to “male” if not provided, but should be specified for best accuracy.
• Unit Consistency: All units match standard laboratory reporting conventions. Some parameters (e.g., ALB, BILI, BUN, CA, CR, GLU, HDL, LDL, PHOS, TG, UA, B12, B9, GLOB, PROT) may require conversion from common lab units (see implementation notes).
• LinAgeCI: The LinAge Comorbidity Index quantifies an individual’s total burden of 22 specific chronic diseases and conditions. It can be provided directly as a number between 0-1, or calculated automatically from the individual’s diagnostic data (AN_DX, AP_DX, AR_DX, AS_DX, CA_DX, CB_DX, CHD_DX, CI_DX, DM_DX, EMPH_DX, HTN_DX, LD_DX, OB_DX, OP_DX, PHF_DX, PMI_DX, POH_DX, PS_DX, PSF_DX, PWF_DX, RI_DX, TD_DX). If LinAgeCI is provided directly, the individual diagnosis flags are ignored.
• LinAgeHUI: The LinAge Healthcare Use Index measures healthcare utilization by counting the number of times an individual has seen a doctor or other healthcare professional in the past 12 months. This includes visits to doctor’s offices, clinics, hospital emergency rooms, home visits, or other healthcare settings, but excludes overnight hospitalizations.
• LinAgeSHI: The LinAge Self-Health Index is a weighted score derived from an individual’s subjective assessment of their general health and how their current health compares to a year prior. It can be provided directly, or calculated automatically from the individual’s general health (GH_DX) and current health (CH_DX) assessments. If LinAgeSHI is provided directly, the individual health assessment parameters are ignored.
• CH_DX: Current health assessment comparing health to one year ago. Valid values are “better”, “same”, or “worse”. This parameter is used to calculate LinAgeSHI if not provided directly.
• GH_DX: General health assessment. Valid values are “good”, “fair”, or “poor”. This parameter is used to calculate LinAgeSHI if not provided directly.

Response Structure

Example Request

{
  "TestType": "LinAge",
  "BirthDate": "1974-12-01",
  "TestDate": "2018-02-01",
  "SEX": "male",
  "ALB": 4.2,
  "ALB_CR_RATIO_URINE": 3.978506488,
  "ALP": 86,
  "ALT": 20,
  "AST": 26,
  "B12": 382.0,
  "B9": 13.51,
  "BASO": 0,
  "BASO_PERCENT": 1,
  "BILI": 0.3976,
  "BMI": 30.94,
  "BUN": 12.89,
  "CA": 9.42,
  "CHOL": 139.97,
  "CL": 106.3,
  "CO2": 21,
  "COT": 200,
  "CR": 0.90,
  "CRP": -21.20,
  "DBP": 95,
  "EOS_PERCENT": 3.4,
  "FE": 83.0,
  "FER": 32,
  "FIB": 3.13,
  "GGT": 25,
  "GLOB": 3.4,
  "GLU": 87.0,
  "HBA1C": 5.5,
  "HCT": 46.2,
  "HDL": 50.65,
  "HGB": 15.4,
  "HR": 58,
  "K": 4.28,
  "LDH": 201,
  "LDL": 85.65,
  "LYMPH": 1.9,
  "LYMPH_PERCENT": 41.3,
  "MCH": 30.9,
  "MCHC": 33.5,
  "MCV": 92.3,
  "MONO": 0.5,
  "MONO_PERCENT": 10.5,
  "MPV": 9.4,
  "NA": 140.9,
  "NEUT": 2,
  "NEUT_PERCENT": 43.8,
  "NTPROBNP": 3.670715483,
  "PHOS": 3.0,
  "PLT": 167,
  "PROT": 7.6,
  "RBC": 5,
  "RDW": 13.7,
  "SBP": 142,
  "TG": 41.98,
  "TIBC": 52.98,
  "TSAT": 28,
  "UA": 6.0,
  "WBC": 4.6,
  "AN_DX": false,
  "AP_DX": false,
  "AR_DX": false,
  "AS_DX": false,
  "CA_DX": false,
  "CB_DX": false,
  "CHD_DX": false,
  "CI_DX": false,
  "DM_DX": false,
  "EMPH_DX": false,
  "HTN_DX": true,
  "LD_DX": false,
  "OB_DX": true,
  "OP_DX": false,
  "PHF_DX": false,
  "PMI_DX": false,
  "POH_DX": false,
  "PS_DX": false,
  "PSF_DX": false,
  "PWF_DX": false,
  "RI_DX": false,
  "TD_DX": false,
  "CH_DX": "same",
  "GH_DX": "good"
}

Example Response

{
  "function": "LincolnCannonLLCBiometric-prod-calculate",
  "result": {
    "biological": 48.54,
    "chronological": 43.17,
    "difference": 5.37,
    "LinAge": 48.53706559
  },
  "message": "For a person with the specified biometrics and test date, we calculated a chronological age of 43.17 years and an estimated biological age of 48.54 years, which differ by 5.37 years."
}

Implementation Examples

JavaScript Implementation

async function calculateLinAge(biometricData) {
    const requestBody = {
        TestType: "LinAge",
        ...biometricData
    };

    try {
        const response = await fetch('https://api.lincolncannon.co/biometric/calculate', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json',
                'x-api-key': process.env.API_KEY
            },
            body: JSON.stringify(requestBody)
        });

        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error calculating LinAge:', error);
        throw error;
    }
}

// Usage example
const linAgeData = {
    BirthDate: '1974-12-01',
    TestDate: '2018-02-01',
    ALT: 20,
    ALB: 4.2,
    ALP: 86,
    // ... other biometrics ...
    SEX: 'male'
};

const linAgeResult = await calculateLinAge(linAgeData);
console.log('Biological Age:', linAgeResult.result.biological);
console.log('Age Difference:', linAgeResult.result.difference);

Python Implementation

import requests
import os

class LinAgeCalculator:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://api.lincolncannon.co/biometric/calculate"
        self.headers = {
            'Content-Type': 'application/json',
            'x-api-key': api_key
        }

    def calculate_linage(self, biometric_data):
        """Calculate biological age using LinAge"""
        request_body = {
            "TestType": "LinAge",
            **biometric_data
        }

        try:
            response = requests.post(
                self.base_url,
                headers=self.headers,
                json=request_body
            )
            response.raise_for_status()
            return response.json()
        except requests.exceptions.RequestException as e:
            print(f"Error calculating LinAge: {e}")
            raise

# Usage example
calculator = LinAgeCalculator(os.getenv('API_KEY'))

linage_data = {
    'BirthDate': '1974-12-01',
    'TestDate': '2018-02-01',
    'ALT': 20,
    'ALB': 4.2,
    'ALP': 86,
    # ... other biometrics ...
    'SEX': 'male'
}

linage_result = calculator.calculate_linage(linage_data)
print(f"Biological Age: {linage_result['result']['biological']} years")
print(f"Age Difference: {linage_result['result']['difference']} years")

Error Handling

Common Error Responses

Error Response Format

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "BirthDate Is Invalid: BirthDate Is Required",
    "details": {
      "field": "BirthDate",
      "value": null
    }
  }
}

Specific Validation Errors

Authentication

API Key Requirements

All requests to the LinAge API require authentication using an API key:

1. Obtain API Key: Contact Lincoln Cannon LLC to receive your API key
2. Include in Headers: Add your API key to the x-api-key header

Security Best Practices

Support & Troubleshooting

Common Issues

Testing Your Integration

1. Validate Date Formats: Ensure all dates use YYYY-MM-DD format
2. Check Biometric Ranges: Verify biometric values are realistic and within expected ranges
3. Error Handling: Implement proper error handling for API responses
4. Unit Verification: Confirm all biometric values use the correct units

Getting Help

If you encounter issues with the LinAge API:

1. Check Documentation: Review this guide for parameter requirements
2. Validate Input Data: Ensure all required fields are provided with correct formats
3. Test with Sample Data: Use the provided examples to verify your implementation
4. Contact Support: Reach out to Lincoln Cannon LLC for technical assistance