Zum Hauptinhalt springen

Body site and pathology

These fields describe where the lesion is located (bodySite) and what condition the device suspects (pathology). They appear at the top level of the data payload and are the primary keys you use to route a report to downstream workflows.

The bodySite object is ALWAYS present in the response (never null). The pathology object is null until the most-probable conclusion crosses the confidence threshold.

"bodySite": {
  "code": "headFront",
  "name": "Face and neck"
},
"pathology": {
  "name": "Acne",
  "code": "Acne",
  "icd11": "ED80"
}

Body site​

  • bodySite.code: camelCase identifier for the body site, for example headFront, trunkFront, armLeft. Match on the exact camelCase string; do not assume SCREAMING_SNAKE_CASE.
  • bodySite.name: human-readable label for the body site. Translated by the locale query parameter.
  • The bodySite object is ALWAYS present in the response (never null).

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.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.

Pathology​

For pathology (the whole object may be null):

  • pathology.code: stable, human-readable internal identifier such as Acne, Psoriasis, Cutaneous melanoma. Drawn from a database-backed catalog of roughly 309 conditions, plus any custom condition a tenant has added via the admin. Treat it as a known-list-with-extensions: do not assume a closed set for validation, but you can switch on the well-known codes for routing.
  • pathology.name: human-readable condition label. Translated by the locale query parameter.
  • pathology.icd11: ICD-11 code for the condition; null when no ICD-11 mapping has been recorded for that condition. A single pathology may carry several ICD-11 codes comma-separated, e.g. "EA90.42, EA90.5Y".
  • The whole pathology object is null until the most-probable conclusion crosses the confidence threshold.

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