Get result - Health Yourself

Get result detail (wellbeing outcome summaries and artifacts)

curl --request GET \
  --url https://api.idunox.com/v1/results/{resultId} \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.idunox.com/v1/results/{resultId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "resultId": "10000000-0000-4000-8000-000000000001",
  "submissionId": "e0000000-0000-4000-8000-000000000001",
  "partnerSubmissionId": "partner-sub-owned",
  "status": "processing",
  "statusLabel": "Processing",
  "completedAt": "2026-04-12T16:00:00.000Z",
  "outcome": {
    "outcomeId": "wellbeing.cardiovascular",
    "focus": "Cardiovascular Wellbeing",
    "score": 0.12,
    "referencePlacement": "below_reference",
    "referencePlacementLabel": "Below reference threshold",
    "outcomeStatus": "completed",
    "outcomeStatusLabel": "Completed",
    "band": {
      "tier": "low",
      "label": "Lower third · reference cohort"
    },
    "notices": [
      {
        "message": "Some optional inputs were not provided."
      }
    ]
  },
  "artifacts": {
    "items": [
      {
        "artifactId": "20000000-0000-4000-8000-000000000001",
        "type": "pdf",
        "typeLabel": "PDF",
        "availability": "available",
        "availabilityLabel": "Available",
        "access": {
          "downloadUrl": "https://storage.googleapis.com/example-bucket/signed-read-example",
          "expiresAt": "2026-04-12T17:00:00.000Z"
        },
        "generatedAt": "2026-04-12T15:30:00.000Z"
      }
    ]
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid submission payload",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "correlationId": "corr-example-1",
    "details": {}
  }
}

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid or expired API key",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "correlationId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Submission not found",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

GET

results

{resultId}

Get result detail (wellbeing outcome summaries and artifacts)

curl --request GET \
  --url https://api.idunox.com/v1/results/{resultId} \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.idunox.com/v1/results/{resultId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "resultId": "10000000-0000-4000-8000-000000000001",
  "submissionId": "e0000000-0000-4000-8000-000000000001",
  "partnerSubmissionId": "partner-sub-owned",
  "status": "processing",
  "statusLabel": "Processing",
  "completedAt": "2026-04-12T16:00:00.000Z",
  "outcome": {
    "outcomeId": "wellbeing.cardiovascular",
    "focus": "Cardiovascular Wellbeing",
    "score": 0.12,
    "referencePlacement": "below_reference",
    "referencePlacementLabel": "Below reference threshold",
    "outcomeStatus": "completed",
    "outcomeStatusLabel": "Completed",
    "band": {
      "tier": "low",
      "label": "Lower third · reference cohort"
    },
    "notices": [
      {
        "message": "Some optional inputs were not provided."
      }
    ]
  },
  "artifacts": {
    "items": [
      {
        "artifactId": "20000000-0000-4000-8000-000000000001",
        "type": "pdf",
        "typeLabel": "PDF",
        "availability": "available",
        "availabilityLabel": "Available",
        "access": {
          "downloadUrl": "https://storage.googleapis.com/example-bucket/signed-read-example",
          "expiresAt": "2026-04-12T17:00:00.000Z"
        },
        "generatedAt": "2026-04-12T15:30:00.000Z"
      }
    ]
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid submission payload",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "correlationId": "corr-example-1",
    "details": {}
  }
}

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid or expired API key",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "correlationId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Submission not found",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Returns the partner-safe result envelope: pipeline status, one or more wellbeing outcomes, and artifacts with signed download URLs when available.

Key response fields

Field	Description
`resultId`	UUID for this result
`submissionId`	UUID of the originating submission
`partnerSubmissionId`	Your submission reference (when stored)
`status`	Partner pipeline status: `received`, `validating`, `processing`, `completed`, `failed`, …
`statusLabel`	Human-readable status
`completedAt`	ISO-8601 completion timestamp
`outcome`	Primary outcome summary (when present)
`outcomes[]`	All outcome summaries when multiple areas were requested
`outcome.outcomeId`	Public id, e.g. `wellbeing.cardiovascular`
`outcome.score`	Scalar 0–1 (not 0–100)
`outcome.band.tier`	`low`, `medium`, `high`, or `unknown`
`outcome.notices[]`	Partner-safe `{ message }` lines
`artifacts.items[]`	Report artefacts (`json`, `html`, `pdf`)

Example request

curl -H "Authorization: Bearer <your-api-key>" \
  https://api.idunox.com/v1/results/<resultId>

Example response

{
  "resultId": "10000000-0000-4000-8000-000000000001",
  "submissionId": "e0000000-0000-4000-8000-000000000001",
  "partnerSubmissionId": "hy-sub-0001",
  "status": "completed",
  "statusLabel": "Completed",
  "completedAt": "2026-04-12T16:00:00.000Z",
  "outcome": {
    "outcomeId": "wellbeing.cardiovascular",
    "focus": "Cardiovascular Wellbeing",
    "score": 0.72,
    "referencePlacement": "above_reference",
    "referencePlacementLabel": "Above reference threshold",
    "outcomeStatus": "completed",
    "outcomeStatusLabel": "Completed",
    "band": {
      "tier": "high",
      "label": "Upper third · reference cohort"
    },
    "notices": []
  },
  "outcomes": [
    {
      "outcomeId": "wellbeing.cardiovascular",
      "focus": "Cardiovascular Wellbeing",
      "score": 0.72,
      "referencePlacement": "above_reference",
      "referencePlacementLabel": "Above reference threshold",
      "outcomeStatus": "completed",
      "outcomeStatusLabel": "Completed",
      "band": { "tier": "high", "label": "Upper third · reference cohort" },
      "notices": []
    },
    {
      "outcomeId": "wellbeing.renal",
      "focus": "Renal Wellbeing",
      "score": 0.41,
      "referencePlacement": "below_reference",
      "referencePlacementLabel": "Below reference threshold",
      "outcomeStatus": "completed",
      "outcomeStatusLabel": "Completed",
      "band": { "tier": "low", "label": "Lower third · reference cohort" },
      "notices": []
    }
  ],
  "artifacts": {
    "items": [
      {
        "artifactId": "20000000-0000-4000-8000-000000000001",
        "type": "html",
        "typeLabel": "HTML",
        "availability": "available",
        "availabilityLabel": "Available",
        "access": {
          "downloadUrl": "https://storage.googleapis.com/example-bucket/signed-read-example",
          "expiresAt": "2026-04-12T17:00:00.000Z"
        },
        "generatedAt": "2026-04-12T15:30:00.000Z"
      }
    ]
  }
}

See Outcomes model for field interpretation.

Authorizations

X-Api-Key

string

header

required

Plaintext API key issued for the tenant (stored hashed server-side).

Headers

x-request-id

string

Optional; echoed when possible. Server generates when absent.

Path Parameters

resultId

string<uuid>

required

Response

Result scoped to tenant; partner scoping follows submission metadata

Partner GET /v1/results/:id. Minimal fields: ids, submission status, completion time, public outcome summary(ies), and artifact download handles. Multi-outcome runs include outcomes (array, same order as stored inference bundle); outcome remains the primary (first) row for backward compatibility. Omits internal job ids, subject linkage, model metadata, and citation placeholders.

resultId

string<uuid>

required

submissionId

string<uuid>

required

partnerSubmissionId

string | null

required

status

enum<string>

required

Stable public slug for submission pipeline state (partner JSON).

Available options:

received,

validating,

validated,

processing,

completed,

failed,

rejected

statusLabel

string

required

Minimum string length: 1

completedAt

string<date-time>

required

Wall time when the result row was last updated (completion / refresh).

outcome

null | object

required

The primary (first) outcome; null when not yet available.

Show child attributes

artifacts

object

required

Show child attributes

outcomes

object[]

Included when more than one wellbeing outcome was scored. Order matches the persisted multi-outcome bundle. Omitted for single-outcome results (use outcome only).

Show child attributes

​Key response fields

​Example request

​Example response

Authorizations

Headers

Path Parameters

Response

Key response fields

Example request

Example response