M42

List Patient Topology

get

Patient-level UMAP coordinates + predicted risk for the Self-Image scatter. Hand-seeded demo data (no ML training). Paginated.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
clusterany ofOptional
string · min: 1 · max: 64Optional
or
nullOptional
risk_tierany ofOptional
integer · max: 4Optional
or
nullOptional
limitinteger · min: 1 · max: 50000OptionalDefault: 10000
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/patient-topology

List District Metrics

get

Per-district t2d observed vs predicted incidence, capacity gap, and unmet-demand score. Hand-seeded demo data.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
limitinteger · min: 1 · max: 500OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/district-metrics

List Anomaly Alerts

get

Emerging health anomalies with inline causal decomposition, recommended actions, and unacted projection. Hand-seeded demo data.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
severityany ofOptional
string · enumOptionalPossible values:
or
nullOptional
limitinteger · min: 1 · max: 500OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/anomaly-alerts

List Forecast Fan

get

Forecast fan points (t, median, lower/upper 95% CI) for a named run + scenario. Used by the Sensorium observational fan and the Sims dual-envelope overlay.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
run_idany ofOptional
string · min: 1 · max: 128Optional
or
nullOptional
scenarioany ofOptional
string · enumOptionalPossible values:
or
nullOptional
limitinteger · min: 1 · max: 5000OptionalDefault: 1000
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/forecast-fan

List Positive Signals

get

Small set of positive-trend headline metrics for the Sensorium hero strip. Hand-seeded demo data.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
limitinteger · min: 1 · max: 200OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/positive-signals

List Anomalies Ranked

get

Ranked anomalies for a single indicator (default t2d_risk). Includes inline decomposition + district centroids for the map. Schema-probes the alerts table so it works pre- and post-multi-indicator pipeline expansion.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
indicatorany ofOptional
string · min: 1 · max: 32Optional
or
nullOptional
limitinteger · min: 1 · max: 500OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/anomalies/ranked

List Cluster Summary

get

Per-cluster cohort stats — size, mean age/BMI/HbA1c, prediabetes / T2D %, predicted-risk mean. Powers the Patient Profile cluster strip.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
limitinteger · min: 1 · max: 500OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/clusters/summary

List Cluster Forecast

get

Per-cluster forecast fan points for the Patient Profile multi-line chart. focus_area defaults to T2D for backward compat.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
focus_areaany ofOptional
string · min: 1 · max: 32Optional
or
nullOptional
limitinteger · min: 1 · max: 5000OptionalDefault: 1000
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/clusters/forecast

List Forecast Draws

get

Sampled subset of raw Poisson bootstrap draws (faint spaghetti curves behind the forecast fan).

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
run_idstring · min: 1 · max: 128OptionalDefault: observational-territory-t2d
scenariostring · min: 1 · max: 32OptionalDefault: baseline
sampleinteger · min: 1 · max: 100OptionalDefault: 20
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/forecast-fan/draws

List Model Registry

get

Fitted GLM coefficients, training-set size, AUROC for each focus-area model. Inline JSON kept as strings — clients parse.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
limitinteger · min: 1 · max: 500OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/model-registry

List Stratified Fits

get

Per-cohort x region GLM fits with pooled fallback. Drives the dashboard's outcome-by-segment comparison view.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
outcome_keyany ofOptional
string · min: 1 · max: 64Optional
or
nullOptional
limitinteger · min: 1 · max: 500OptionalDefault: 50
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/stratified-fits

List Patient Labs

get

Patient-level bronze lab rows ordered by observation_date. Drives the mini-trajectory charts in the Patient Profile drawer.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
patient_idstring · min: 1 · max: 64Required
Query parameters
limitinteger · min: 1 · max: 2000OptionalDefault: 500
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/patients/{patient_id}/labs

Get Patient Note

get

Patient's synthetic clinical note + LLM-extracted structured fields. NLP sample is 500 patients — returns 404 outside that set.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
patient_idstring · min: 1 · max: 64Required
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
patient_idstringRequired
authored_atany ofOptional
string · date-timeOptional
or
nullOptional
authorany ofOptional
stringOptional
or
nullOptional
note_textstringRequired
get
/v1/{workspace_id}/m42/patients/{patient_id}/note

Get Notes Rollup

get

Cohort-wide (or per-cluster / per-district) rollup of NLP extractions joined onto patient-topology risk. Surfaces which narrative signals correlate with higher predicted T2D risk.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
clusterany ofOptional
string · min: 1 · max: 64Optional
or
nullOptional
districtany ofOptional
string · min: 1 · max: 64Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
total_notesintegerRequired
cohort_mean_risknumberRequired
get
/v1/{workspace_id}/m42/notes/rollup

List Catalog

get

Per-table layer + description + row count for the Catalog page.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/catalog
200

Successful Response

Describe Table

get

Column metadata (name, type, comment) for one allowlisted m42 table.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
tablestring · min: 1 · max: 64Required
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/catalog/{table}/columns

Sample Table

get

Up to limit raw rows from one allowlisted m42 table for preview.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
tablestring · min: 1 · max: 64Required
Query parameters
limitinteger · min: 1 · max: 50OptionalDefault: 5
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/catalog/{table}/sample

List Features

get

Allowlist of feature columns (continuous or binary) for the Explore UI.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
countintegerRequired
get
/v1/{workspace_id}/m42/features
200

Successful Response

Feature Distribution

get

Histogram bins for one allowlisted feature, stratified by y_t2d_1yr outcome. Continuous features get bins buckets; binary features collapse to 2.

Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
featurestring · min: 1 · max: 64Required
binsinteger · min: 2 · max: 40OptionalDefault: 20
Responses
chevron-right
200

Successful Response

application/json
workspace_idstring · uuidRequired
featurestringRequired
kindstringRequired
n_totalintegerRequired
n_y1integerRequired
get
/v1/{workspace_id}/m42/features/distribution

Last updated

Was this helpful?