Inner Age

Inner Age helps Users understand how their calculated biological age compares with their chronological age. It is a proprietary summary measure based on blood biomarkers and body mass index (BMI), with a lower biological age generally indicating a more favorable health profile relative to chronological age.

The Inner Age APIs return User-specific result summaries and marker-level contribution details that can support dashboards, result-detail views, and longitudinal progress experiences. Inner Age is not only a score: the response can also show how biomarkers contributed to the result, which helps your application explain why a User's Inner Age changed and which markers may be useful to review.

Where This Fits

Use this page after you have created a linked customer record and added or ordered blood result data for the User. This page focuses on retrieving and presenting the Inner Age output.

What Inner Age Is

Inner Age estimates biological age from weighted blood biomarker values and BMI. The model uses age-related health outcomes and biomarkers that have meaningful relationships with age. A User's biological age can then be compared with their chronological age to summarize whether the User's current biomarker profile appears more or less favorable than expected for their age.

Biomarkers are selected independently for males and females. InsideTracker evaluates how strongly each biomarker correlates with age, then refines the model so selected biomarkers contribute distinct information rather than duplicating the same signal.

Inner Age can still be calculated when a User does not have every biomarker in the full model, as long as the result satisfies at least one qualifying minimum biomarker set. Fewer available biomarkers can reduce confidence in the prediction, so the result includes a strength value alongside the calculated biological age.

Data Needed For This Output

Inner Age is not calculated for Immunity and Advanced Home Kit results because the calculation strength is too low for those result types.

Workflow

Use the Inner Age APIs in two layers:

GET /inner-age/customer/v1/results
Authorization: Bearer {customer_access_token}

GET /api/customer/v1/inner-age/markers
Authorization: Bearer {customer_access_token}

Output Availability

Calculation Eligibility

Inner Age uses InsideTracker-defined biomarker sets selected for their relationship to aging. The biomarkers that compose Inner Age depend on the User's configured biological sex, and a result must satisfy at least one applicable minimum set before Inner Age can be calculated. A User can retrieve Inner Age when any one of the applicable sets is satisfied; satisfying multiple or all sets uses the same retrieval workflow.

Results can be calculated without every biomarker in the full model, but the returned strength can decrease when less model input is available.

For female Users, Essentials is covered by the other minimum sets. The additional configured male set applies when enabled for a Partner or program-specific configuration.

For the full male and female biomarker composition, see Inner Age Biomarkers.

Inner Age And Optimal Zones

Inner Age and personalized optimal zones are related, but they are not the same output.

A biomarker can contribute years to Inner Age even when the biomarker is inside its personalized optimal zone. Do not treat optimal-zone status and Inner Age contribution as interchangeable fields in your UI.

When presenting Inner Age detail:

• Show the Inner Age score and marker contribution context separately from optimal-zone charts.
• Use marker contribution fields from the Inner Age response to explain biological-age impact.
• Use Optimal Zones and recommendation APIs for marker status and action guidance.
• Do not assume every marker that contributes years to Inner Age will have a recommendation.

Get Inner Age Results

Use this endpoint to retrieve the full list of Inner Age results related to the authenticated User.

GET /inner-age/customer/v1/results
Authorization: Bearer {customer_access_token}

The response includes a results array. Each result can include:

Example response shape:

{
  "results": [
    {
      "id": 213042,
      "bloodResultId": 412412312,
      "testedAt": "2024-07-16",
      "chronologicalAge": 30.2,
      "biologicalAge": 29.1,
      "projectedBestBioAge": 25,
      "projectedWorstBioAge": 45,
      "strength": 5,
      "markerContributions": [
        {
          "id": "Glu",
          "value": 3.1,
          "isOutOfRange": "true"
        }
      ]
    }
  ]
}

Get The Full Inner Age Marker Response

Use this endpoint when your interface needs the marker-level Inner Age payload for the authenticated User.

GET /api/customer/v1/inner-age/markers
Authorization: Bearer {customer_access_token}

The response can include:

Marker objects can include fields such as abbr, name, unit, value, precision, valueContrib, origValueContrib, percentOfAge, outZone, thresholdValue, and range values. Use the fields returned by the API instead of hard-coding marker names, units, or explanatory text.

Response Codes

Authentication failures follow the standard customer-level token handling described in Authorization and Security.

Best Practices

Implementation Checklist

• You have a customer-level access token for the User.
• Your User setup includes birth date and biological sex.
• Your UI handles an empty results array or no available Inner Age result.
• Your data model can connect bloodResultId back to the relevant blood result workflow.
• Your UI handles Immunity and Advanced Home Kit results without implying that Inner Age is missing due to an error.
• Your UI distinguishes Inner Age contribution from personalized optimal-zone status.
• Your result display uses chronologicalAge, biologicalAge, testedAt, and strength only when those fields are present.
• Your detail display uses marker contribution fields returned by the API.
• Your application logs API errors without logging access tokens.

Related API Reference

• GET /inner-age/customer/v1/results
• GET /api/customer/v1/inner-age/markers
• Inner Age Biomarkers