ChronoAge Calculator API

Calculate precise chronological age metrics using our ChronoAge API. This endpoint provides detailed age calculations in years, months, weeks, and days based on birth and test dates. For practical use cases, read more about our ChronoAge Calculator. 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

Response Structure

Example Request

{
  "TestType": "ChronoAge",
  "BirthDate": "1974-12-01",
  "TestDate": "2024-01-31"
}

Example Response

{
  "function": "LincolnCannonLLCBiometric-prod-calculate",
  "result": {
    "days": 17958,
    "months": 590,
    "monthsWeeksDays": {
      "months": 589,
      "weeks": 4,
      "days": 2
    },
    "weeks": 2565.43,
    "weeksDays": {
      "weeks": 2565,
      "days": 3
    },
    "years": 49.17,
    "yearsMonthsWeeksDays": {
      "years": 49,
      "months": 1,
      "weeks": 4,
      "days": 2
    }
  },
  "message": "For a person with the specified birth and calculation dates, we calculated a chronological age of 49 years, 1 months, 4 weeks, and 2 days. This is the equivalent of 49.17 years, or 590 months, or 2565.43 weeks, or 17958 days."
}

Implementation Examples

JavaScript Implementation

async function calculateChronoAge(birthDate, testDate = null) {
    const requestBody = {
        TestType: "ChronoAge",
        BirthDate: birthDate,
        ...(testDate && { TestDate: testDate })
    };

    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 ChronoAge:', error);
        throw error;
    }
}

// Usage example
const chronoAgeResult = await calculateChronoAge('1974-12-01', '2024-01-31');
console.log('Chronological Age:', chronoAgeResult.result.years);

Python Implementation

import requests
import os

class ChronoAgeCalculator:
    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_chrono_age(self, birth_date, test_date=None):
        """Calculate chronological age"""
        request_body = {
            "TestType": "ChronoAge",
            "BirthDate": birth_date
        }
        
        if test_date:
            request_body["TestDate"] = test_date

        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 ChronoAge: {e}")
            raise

# Usage example
calculator = ChronoAgeCalculator(os.getenv('API_KEY'))
chrono_result = calculator.calculate_chrono_age('1974-12-01', '2024-01-31')
print(f"Chronological Age: {chrono_result['result']['years']} years")

Error Handling

Common Error Responses

Error Response Format

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid birth date format. Expected YYYY-MM-DD",
    "details": {
      "field": "BirthDate",
      "value": "1974/12/01"
    }
  }
}

Authentication

API Key Requirements

All requests to the ChronoAge 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. Test with Sample Data: Use the provided examples to verify your implementation
3. Error Handling: Implement proper error handling for API responses

Getting Help

If you encounter issues with the ChronoAge 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