> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Media

> A photo, video, or audio recording acquired or used in healthcare. The actual content may be inline or provided by direct reference.

## Properties

| Name        | Required | Type                                                                                                                                                                                                                                                                                                                                                                                                               | Description                                                                                       |
| ----------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| identifier  | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                                                                                                                                                                                                           | Identifier(s) for the image                                                                       |
| basedOn     | No       | Reference\<[ServiceRequest](/medical-api/fhir/resources/servicerequest) / [CarePlan](/medical-api/fhir/resources/careplan)>\[]                                                                                                                                                                                                                                                                                     | Procedure that caused this media to be created                                                    |
| partOf      | No       | Reference\<Resource>\[]                                                                                                                                                                                                                                                                                                                                                                                            | Part of referenced event                                                                          |
| status      | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                               | preparation / in-progress / not-done / on-hold / stopped / completed / entered-in-error / unknown |
| type        | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Classification of media as image, video, or audio                                                 |
| modality    | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | The type of acquisition equipment/process                                                         |
| view        | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Imaging view, e.g. Lateral or Antero-posterior                                                    |
| subject     | No       | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Group](/medical-api/fhir/resources/group) / [Device](/medical-api/fhir/resources/device) / [Specimen](/medical-api/fhir/resources/specimen) / [Location](/medical-api/fhir/resources/location)>                         | Who/What this Media is a record of                                                                |
| encounter   | No       | Reference\<[Encounter](/medical-api/fhir/resources/encounter)>                                                                                                                                                                                                                                                                                                                                                     | Encounter associated with media                                                                   |
| created\[x] | No       | dateTime, [Period](/medical-api/fhir/data-types/period)                                                                                                                                                                                                                                                                                                                                                            | When Media was collected                                                                          |
| issued      | No       | instant                                                                                                                                                                                                                                                                                                                                                                                                            | Date/Time this version was made available                                                         |
| operator    | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Organization](/medical-api/fhir/resources/organization) / [CareTeam](/medical-api/fhir/resources/careteam) / [Patient](/medical-api/fhir/resources/patient) / [Device](/medical-api/fhir/resources/device) / [RelatedPerson](/medical-api/fhir/resources/relatedperson)> | The person who generated the image                                                                |
| reasonCode  | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                 | Why was event performed?                                                                          |
| bodySite    | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Observed body part                                                                                |
| deviceName  | No       | string                                                                                                                                                                                                                                                                                                                                                                                                             | Name of the device/manufacturer                                                                   |
| device      | No       | Reference\<[Device](/medical-api/fhir/resources/device) / [DeviceMetric](/medical-api/fhir/resources/devicemetric) / [Device](/medical-api/fhir/resources/device)>                                                                                                                                                                                                                                                 | Observing Device                                                                                  |
| height      | No       | positiveInt                                                                                                                                                                                                                                                                                                                                                                                                        | Height of the image in pixels (photo/video)                                                       |
| width       | No       | positiveInt                                                                                                                                                                                                                                                                                                                                                                                                        | Width of the image in pixels (photo/video)                                                        |
| frames      | No       | positiveInt                                                                                                                                                                                                                                                                                                                                                                                                        | Number of frames if > 1 (photo)                                                                   |
| duration    | No       | decimal                                                                                                                                                                                                                                                                                                                                                                                                            | Length in seconds (audio / video)                                                                 |
| content     | Yes      | [Attachment](/medical-api/fhir/data-types/attachment)                                                                                                                                                                                                                                                                                                                                                              | Actual Media - reference or data                                                                  |
| note        | No       | [Annotation](/medical-api/fhir/data-types/annotation)\[]                                                                                                                                                                                                                                                                                                                                                           | Comments made about the media                                                                     |

## Search Parameters

| Name       | Type      | Description                                                                                       | Expression       |
| ---------- | --------- | ------------------------------------------------------------------------------------------------- | ---------------- |
| based-on   | reference | Procedure that caused this media to be created                                                    | Media.basedOn    |
| created    | date      | When Media was collected                                                                          | Media.created    |
| device     | reference | Observing Device                                                                                  | Media.device     |
| encounter  | reference | Encounter associated with media                                                                   | Media.encounter  |
| identifier | token     | Identifier(s) for the image                                                                       | Media.identifier |
| modality   | token     | The type of acquisition equipment/process                                                         | Media.modality   |
| operator   | reference | The person who generated the image                                                                | Media.operator   |
| patient    | reference | Who/What this Media is a record of                                                                | Media.subject    |
| site       | token     | Observed body part                                                                                | Media.bodySite   |
| status     | token     | preparation / in-progress / not-done / on-hold / stopped / completed / entered-in-error / unknown | Media.status     |
| subject    | reference | Who/What this Media is a record of                                                                | Media.subject    |
| type       | token     | Classification of media as image, video, or audio                                                 | Media.type       |
| view       | token     | Imaging view, e.g. Lateral or Antero-posterior                                                    | Media.view       |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [Media](https://www.hl7.org/fhir/StructureDefinition/Media).
