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.
Authorization
MemberBearer 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
uuidQuery Parameters
251 <= value <= 20000 <= valueOptional exact-match filter on the lab lifecycle state.
Header Parameters
Response Body
application/json
application/json
curl -X GET "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/labs"{
"data": [
{
"lab_result_id": "f0d3eac0-9599-4eef-977f-96a8777c2dd8",
"status": "pending",
"test_date": "2019-08-24",
"lab_name": "string"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 0
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Register an uploaded lab and schedule processing
Two-step upload flow — the partner first calls `POST /v1/uploads` to mint a pre-signed PUT URL, uploads the file to that URL, then calls this endpoint with the returned `file_url`. Returns `202 Accepted` with a partner-facing `lab_result_id` and the Temporal `workflow_id` driving extraction + analysis. Processing runs asynchronously; partners poll either `GET /v1/users/{user_id}/labs/{lab_result_id}` (status transitions: `pending` → `processing` → `ready` / `failed`) or `GET /v1/users/{user_id}/jobs/{job_id}` (raw Temporal workflow state). Both round-trip through the same execution. If the workflow start fails, the row stays in `pending` and `workflow_id` is `null`; partners should retry the upload.
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.