Skip to main content
curl --request POST \
  --url https://api.heliosai.health/api/v1/lab-results \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "webhookUrl": "https://your-server.com/webhook/helios",
  "labResults": [
    {
      "name": "Hemoglobin A1c",
      "value": "7.2%",
      "flag": "High",
      "referenceRange": "4.0-5.6%",
      "date": "2025-01-15"
    }
  ]
}
'
{
  "runId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "accepted",
  "message": "Request accepted. Results will be delivered to your webhook."
}

Authorizations

​
x-api-key
string
header
required

API key provided by Helios Intelligence

Body

application/json
​
labResults
object[]
required

Array of lab test results to analyze. Dates are recommended for proper recency-based sorting. Max 200 labs processed.

Minimum array length: 1
​
patientContext
object

Patient context for lab interpretation

​
webhookUrl
string<uri>

URL where analysis results will be delivered via webhook

Example:

"https://your-server.com/webhook/helios"

Response

Request accepted - analysis started in background

​
runId
string<uuid>
required

Unique identifier for this analysis run

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
status
enum<string>
required

Request was accepted and processing has started

Available options:
accepted
Example:

"accepted"

​
message
string

Human-readable status message

Example:

"Request accepted. Results will be delivered to your webhook."