Skip to main content

Body site and pathology

The condition block describes the suspected or most likely pathology together with the body site where the lesion was photographed. Both fields use FHIR coding[] arrays so the same condition or location can be expressed in the proprietary catalog and in ICD-11 simultaneously.

"condition": {
  "pathology": null,
  "bodySite": {
    "coding": [
      {
        "system": "https://legit.health/integration/json-only/codes/body-sites",
        "code": "trunkFront",
        "display": "Chest and belly"
      }
    ]
  }
}
  • pathology: May contain the name or code for a confirmed condition. pathology is null when no condition has been set on the report. When set, it follows the same coding[] array shape as result.conclusions[].pathology: two entries, one in the proprietary legit.health/integration/json-only/codes/conditions system and one in ICD-11.
  • bodySite: Provides standardized information about the anatomical location using code, display, and a system that references a coding standard.

When pathology is populated​

"condition": {
  "pathology": {
    "coding": [
      {
        "code": "Psoriasis",
        "display": "Psoriasis",
        "system": "https://legit.health/integration/json-only/codes/conditions"
      },
      {
        "code": "EA90",
        "display": "Psoriasis",
        "system": "ICD-11"
      }
    ]
  },
  "bodySite": { ... }
}

pathology.coding[0] is the proprietary legit.health/integration/json-only/codes/conditions entry. pathology.coding[0].code is a stable, human-readable internal identifier ("Psoriasis", "Cutaneous melanoma", "Acne", ...) drawn from a database-backed catalog of roughly 309 base conditions, plus any per-tenant custom condition. Treat it as a known-list-with-extensions.

pathology.coding[1] is the ICD-11 mapping (system is the literal string "ICD-11" with a hyphen). pathology.coding[1].code may be a single ICD-11 code (e.g. "EA90") or several comma-separated codes when one proprietary condition maps to multiple ICD-11 entries (e.g. "EA90.42, EA90.5Y"). code is null when no ICD-11 mapping exists for that condition.

The full ranked list of pathologies the device considered for the case is documented in Conditions.

Body site​

bodySite is always present in the response (never null). bodySite.coding[0].code is a camelCase identifier (e.g. headFront, trunkFront, armLeft). Match on the exact camelCase string; do not assume SCREAMING_SNAKE_CASE. bodySite.coding[0].display is the human-readable label, translated by the locale query parameter.

The complete list of supported body-site codes and their multilingual names can be fetched from a public, unauthenticated endpoint:

GET https://medical-device-params.legit.health/v2.0/body-sites

The response is an array of objects with two fields:

  • code: the camelCase identifier emitted under bodySite.coding[0].code (e.g. headFront, armLeft, trunkFront).
  • name: an object keyed by locale (en_GB, es_ES, pt_BR, it_IT, fr_FR, de_DE, bg_BG, pl_PL, ko_KO, ca_ES) with the translated display name.

Use this endpoint as the source of truth: the list can grow over time as new body sites are added.