Thrive AI Health
Api reference

Retrieve full lab result with extracted biomarkers and analysis

Full record including extracted values bucketed across the six physiological domains and an overall AI-generated analysis. While `status != ready`, `domains` and `analysis` return their empty/null defaults — partners can render a skeleton UI without special-casing in-flight results.

GET
/v1/users/{user_id}/labs/{lab_result_id}

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
lab_result_id*Lab Result 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/labs/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "data": {
    "lab_result_id": "f0d3eac0-9599-4eef-977f-96a8777c2dd8",
    "status": "pending",
    "test_date": "2019-08-24",
    "lab_name": "string",
    "title": "string",
    "confidence": 0,
    "domains": [
      {
        "domain_name": "string",
        "domain_insight": "string",
        "values": [
          {
            "parameter": "string",
            "value": 0,
            "comparator": ">",
            "unit": "string",
            "reference_range": {
              "low": 0,
              "high": 0
            },
            "status": "In Range",
            "explanation": "string"
          }
        ]
      }
    ],
    "analysis": {
      "overall_assessment": "string",
      "recommendations": "string",
      "follow_up_needed": true,
      "follow_up_reason": "string"
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

List processed and in-flight lab results

Combines pending, processing, ready, and failed results in one paginated read so partners can render an at-a-glance lab history. Sort order is by `created_at` descending.

Get a short-lived signed URL for the original uploaded document

Returns a fresh 15-minute signed URL on each call. Do not cache — request again when the link expires.