Thrive AI Health
Api reference

Biological age score with chronological delta and recommendations

Returns the current biological-age estimate, the member's chronological age, the delta (negative = aging slower), a status bucket, and a small set of AI-generated recommendations bucketed by category. Bio-age is recomputed asynchronously after metrics ingest; this endpoint is read-only. Returns `404` when no profile has been computed yet — partners poll until the background workflow lands one.

GET
/v1/users/{user_id}/bio-age

Authorization

MemberBearer
AuthorizationBearer <token>

Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.

In: header

Path Parameters

user_id*User Id
Formatuuid

Header Parameters

org-id?string|null
x-user-id?string|null
x-request-id?string|null
traceparent?string|null
Idempotency-Key?|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/bio-age"
{
  "data": {
    "chronological_age": 0,
    "biological_age": 0,
    "delta": 0,
    "status": "younger",
    "updated_at": "2019-08-24T14:15:22Z",
    "recommendations": [
      {
        "recommendation_id": "string",
        "title": "string",
        "description": "string",
        "category": "sleep"
      }
    ]
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Historical health scores for trend visualization

Paginated history over a `start_date`/`end_date` window. Each row carries the date, overall score, and a flat `{domain: score}` breakdown for chart rendering.

Historical biological age scores

Paginated history over a `start_date`/`end_date` window for trend visualization. Each row carries the date, biological age, and delta vs chronological age. The window is inclusive on both ends; the lower bound is interpreted as UTC midnight and the upper bound as end-of-day UTC.