Epidemiology

List Prevalence

get

Active-condition prevalence by code x (age_bucket, gender) with Wilson 95% CI. Filter by code, code_system, age_bucket, gender; set min_support_only=true to hide small-cell (observed < 5) cohorts.

Authorizations

BearerAuth

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

codeany ofOptional

string · min: 1 · max: 32Optional

or

nullOptional

code_systemany ofOptional

string · enumOptionalPossible values:

or

nullOptional

age_bucketany ofOptional

string · enumOptionalPossible values:

or

nullOptional

genderany ofOptional

string · min: 1 · max: 32Optional

or

nullOptional

min_support_onlybooleanOptionalDefault: false

limitinteger · min: 1 · max: 500OptionalDefault: 50

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

workspace_idstring · uuidRequired

countintegerRequired

422

Validation Error

application/json

get

/v1/{workspace_id}/epidemiology/prevalence

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/epidemiology/prevalence HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "count": 1,
  "items": [
    {
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "code_system_normalized": "text",
      "code": "text",
      "code_display": "text",
      "age_bucket": "text",
      "gender": "text",
      "patients_with_condition": 1,
      "cohort_size": 1,
      "prevalence_pct": 1,
      "prevalence_ci_lower_pct": 1,
      "prevalence_ci_upper_pct": 1,
      "min_support_met": true,
      "as_of_date": "2026-05-12"
    }
  ]
}

List Trends

get

Monthly incidence for a code (YYYY-MM). Requires code. Optional filters: code_system, start_month, end_month, age_bucket, gender.

Authorizations

BearerAuth

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

codestring · min: 1 · max: 32Required

code_systemany ofOptional

string · enumOptionalPossible values:

or

nullOptional

start_monthany ofOptional

stringOptionalPattern: ^\d{4}-(0[1-9]|1[0-2])$

or

nullOptional

end_monthany ofOptional

stringOptionalPattern: ^\d{4}-(0[1-9]|1[0-2])$

or

nullOptional

age_bucketany ofOptional

string · enumOptionalPossible values:

or

nullOptional

genderany ofOptional

string · min: 1 · max: 32Optional

or

nullOptional

limitinteger · min: 1 · max: 500OptionalDefault: 120

Responses

200

Successful Response

application/json

workspace_idstring · uuidRequired

codestringRequired

countintegerRequired

422

Validation Error

application/json

get

/v1/{workspace_id}/epidemiology/trends

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/epidemiology/trends?code=text HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "code": "text",
  "count": 1,
  "items": [
    {
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "code_system_normalized": "text",
      "code": "text",
      "code_display": "text",
      "year_month": "text",
      "age_bucket": "text",
      "gender": "text",
      "incident_patients": 1,
      "condition_records": 1
    }
  ]
}

List Cohort Drivers

get

Standardized Prevalence Ratio (SPR = observed / expected) per (age_bucket, gender) cohort for a given code, with Byar 95% CI. SPR > 1 = cohort over-indexes for this code.

Authorizations

BearerAuth

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

codestring · min: 1 · max: 32Required

code_systemany ofOptional

string · enumOptionalPossible values:

or

nullOptional

min_support_onlybooleanOptionalDefault: true

limitinteger · min: 1 · max: 500OptionalDefault: 20

Responses

200

Successful Response

application/json

workspace_idstring · uuidRequired

codestringRequired

countintegerRequired

422

Validation Error

application/json

get

/v1/{workspace_id}/epidemiology/cohort-drivers

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/epidemiology/cohort-drivers?code=text HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "code": "text",
  "count": 1,
  "items": [
    {
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "code_system_normalized": "text",
      "code": "text",
      "code_display": "text",
      "age_bucket": "text",
      "gender": "text",
      "observed": 1,
      "expected": 1,
      "cohort_size": 1,
      "workspace_patients_with_condition": 1,
      "workspace_population": 1,
      "workspace_baseline_rate": 1,
      "spr": 1,
      "spr_ci_lower": 1,
      "spr_ci_upper": 1,
      "min_support_met": true,
      "as_of_date": "2026-05-12"
    }
  ]
}

List Cooccurrence

get

Active-condition code pairs co-occurring within the same patient. Emits Jaccard, lift, PMI, and Pearson χ². Filter by code to constrain one side of the pair; sort by lift|pmi|chi_square|jaccard.

Authorizations

BearerAuth

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

codeany ofOptional

string · min: 1 · max: 32Optional

or

nullOptional

code_systemany ofOptional

string · enumOptionalPossible values:

or

nullOptional

sort_bystring · enumOptionalDefault: liftPossible values:

min_support_onlybooleanOptionalDefault: true

limitinteger · min: 1 · max: 500OptionalDefault: 50

Responses

200

Successful Response

application/json

workspace_idstring · uuidRequired

sort_bystringRequired

countintegerRequired

422

Validation Error

application/json

get

/v1/{workspace_id}/epidemiology/cooccurrence

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/epidemiology/cooccurrence HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "sort_by": "text",
  "count": 1,
  "items": [
    {
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "code_system_normalized": "text",
      "code_a": "text",
      "code_a_display": "text",
      "code_b": "text",
      "code_b_display": "text",
      "n_patients_a": 1,
      "n_patients_b": 1,
      "n_patients_both": 1,
      "expected_both": 1,
      "jaccard": 1,
      "lift": 1,
      "pmi": 1,
      "chi_square": 1,
      "min_support_met": true,
      "as_of_date": "2026-05-12"
    }
  ]
}

List Patient Burden

get

Per-patient condition features including Charlson Comorbidity Index (Quan 2005 ICD-10) and age-adjusted CCI (Charlson 1994). Filter by min_charlson, age range, or gender. Sort by any of the numeric feature columns.

Authorizations

BearerAuth

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

min_charlsonany ofOptional

integer · max: 40Optional

or

nullOptional

age_minany ofOptional

integer · max: 120Optional

or

nullOptional

age_maxany ofOptional

integer · max: 120Optional

or

nullOptional

genderany ofOptional

string · min: 1 · max: 32Optional

or

nullOptional

sort_bystring · enumOptionalDefault: age_adjusted_charlson_indexPossible values:

limitinteger · min: 1 · max: 500OptionalDefault: 50

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

workspace_idstring · uuidRequired

countintegerRequired

sort_bystringRequired

422

Validation Error

application/json

get

/v1/{workspace_id}/epidemiology/patient-burden

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/epidemiology/patient-burden HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "count": 1,
  "sort_by": "text",
  "items": [
    {
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "patient_entity_id": "123e4567-e89b-12d3-a456-426614174000",
      "gender": "text",
      "age_now": 1,
      "age_bucket_now": "text",
      "n_active_conditions": 1,
      "n_distinct_codes": 1,
      "n_distinct_code_systems": 1,
      "recent_onset_count_365d": 1,
      "most_recent_active_onset_date": "2026-05-12",
      "oldest_active_onset_date": "2026-05-12",
      "days_since_most_recent_onset": 1,
      "n_lifetime_condition_records": 1,
      "n_lifetime_distinct_codes": 1,
      "charlson_index": 1,
      "age_cci_points": 1,
      "age_adjusted_charlson_index": 1,
      "as_of_date": "2026-05-12"
    }
  ]
}

Get Patient Burden

get

Full condition-burden features for a single patient, including per-category Charlson flags (17 Quan 2005 ICD-10 categories).

Authorizations

BearerAuth

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_entity_idstring · uuidRequired

Responses

200

Successful Response

application/json

workspace_idstring · uuidRequired

patient_entity_idstring · uuidRequired

genderany ofOptional

stringOptional

or

nullOptional

age_nowany ofOptional

integerOptional

or

nullOptional

age_bucket_nowany ofOptional

stringOptional

or

nullOptional

n_active_conditionsintegerRequired

n_distinct_codesany ofOptional

integerOptional

or

nullOptional

n_distinct_code_systemsany ofOptional

integerOptional

or

nullOptional

recent_onset_count_365dany ofOptional

integerOptional

or

nullOptional

most_recent_active_onset_dateany ofOptional

string · dateOptional

or

nullOptional

oldest_active_onset_dateany ofOptional

string · dateOptional

or

nullOptional

days_since_most_recent_onsetany ofOptional

integerOptional

or

nullOptional

n_lifetime_condition_recordsany ofOptional

integerOptional

or

nullOptional

n_lifetime_distinct_codesany ofOptional

integerOptional

or

nullOptional

charlson_indexintegerRequired

age_cci_pointsintegerRequired

age_adjusted_charlson_indexintegerRequired

as_of_dateany ofOptional

string · dateOptional

or

nullOptional

422

Validation Error

application/json

get

/v1/{workspace_id}/epidemiology/patient-burden/{patient_entity_id}

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/epidemiology/patient-burden/{patient_entity_id} HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "patient_entity_id": "123e4567-e89b-12d3-a456-426614174000",
  "gender": "text",
  "age_now": 1,
  "age_bucket_now": "text",
  "n_active_conditions": 1,
  "n_distinct_codes": 1,
  "n_distinct_code_systems": 1,
  "recent_onset_count_365d": 1,
  "most_recent_active_onset_date": "2026-05-12",
  "oldest_active_onset_date": "2026-05-12",
  "days_since_most_recent_onset": 1,
  "n_lifetime_condition_records": 1,
  "n_lifetime_distinct_codes": 1,
  "charlson_index": 1,
  "age_cci_points": 1,
  "age_adjusted_charlson_index": 1,
  "as_of_date": "2026-05-12",
  "charlson_flags": {
    "myocardial_infarction": 0,
    "congestive_heart_failure": 0,
    "peripheral_vascular_disease": 0,
    "cerebrovascular_disease": 0,
    "dementia": 0,
    "chronic_pulmonary_disease": 0,
    "rheumatic_disease": 0,
    "peptic_ulcer_disease": 0,
    "mild_liver_disease": 0,
    "diabetes_without_complication": 0,
    "diabetes_with_complication": 0,
    "hemiplegia_or_paraplegia": 0,
    "renal_disease": 0,
    "any_malignancy": 0,
    "moderate_severe_liver_disease": 0,
    "metastatic_solid_tumor": 0,
    "hiv_aids": 0
  }
}