Skip to main content

Media

Two fields in the FHIR payload carry imagery for the case: macroscopicMedia at the top level of data (the lesion photo submitted for analysis, as a FHIR Media resource), and result.observations (the array of every media that was actually sent to the algorithm for analysis).

macroscopicMedia​

macroscopicMedia references a FHIR Media resource with a signed URL to the uploaded file.

"macroscopicMedia": {
  "resourceType": "Media",
  "content": {
    "url": "https://...jpg"
  },
  "type": "Image",
  "annotations": null
}
  • resourceType: Always "Media".
  • content.url: A direct URL to access the uploaded file, typically a signed URL valid for a limited time.
  • type: media format. One of "Image" or "Video". null when the original upload had no recorded type (which happens together with the whole macroscopicMedia object being itself null).
  • annotations: always null in the FHIR view, even when the raw view exposes detections for the same image. Detection data is exposed instead per scoring system, in result.questionnaires[].explainabilityMedia.annotations.

result.observations​

The result.observations array references each media file examined by the diagnostic engine. Every entry wraps a single FHIR Media resource together with its modality and quality score.

"observations": [
  {
    "media": {
      "resourceType": "Media",
      "content": { "url": "..." },
      "type": "Image",
      "modality": "Clinical",
      "diqaScore": 86.0
    }
  },
  ...
]
  • media.resourceType: always "Media".
  • media.content.url: signed S3 URL to the file. Time-limited (about 30 minutes).
  • media.type: media format. One of "Image" or "Video". Always present.
  • media.modality: how the image was captured. One of "None", "Clinical", "Dermoscopic", or null. null for video uploads or when image-validity did not run. The value is "Dermoscopic", not "Dermoscopy".
  • media.diqaScore: Dermatology Image Quality Assessment score on a 0 to 100 scale (float). null for videos or when DIQA was not computed.
  • Each observation contains only the media key. The v3 FHIR response does not emit originalMedia (that field is v2-only).