> ## 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. # DeviceRequest > Represents a request for a patient to employ a medical device. The device may be an implantable device, or an external assistive device, such as a walker. ## Properties | Name | Required | Type | Description | | --------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | identifier | No | [Identifier](/medical-api/fhir/data-types/identifier)\[] | External Request identifier | | instantiatesCanonical | No | canonical\[] | Instantiates FHIR protocol or definition | | instantiatesUri | No | uri\[] | Instantiates external protocol or definition | | basedOn | No | Reference\\[] | What request fulfills | | priorRequest | No | Reference\\[] | What request replaces | | groupIdentifier | No | [Identifier](/medical-api/fhir/data-types/identifier) | Identifier of composite request | | status | No | code | draft / active / on-hold / revoked / completed / entered-in-error / unknown | | intent | Yes | code | proposal / plan / directive / order / original-order / reflex-order / filler-order / instance-order / option | | priority | No | code | routine / urgent / asap / stat | | code\[x] | Yes | Reference\<[Device](/medical-api/fhir/resources/device)>, [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Device requested | | parameter | No | DeviceRequestParameter | Device details | | - id | No | string | Unique id for inter-element referencing | | - 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 even if unrecognized | | - code | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Device detail | | - value\[x] | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), [Quantity](/medical-api/fhir/data-types/quantity), [Range](/medical-api/fhir/data-types/range), boolean | Value of detail | | subject | Yes | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Group](/medical-api/fhir/resources/group) / [Location](/medical-api/fhir/resources/location) / [Device](/medical-api/fhir/resources/device)> | Focus of request | | encounter | No | Reference\<[Encounter](/medical-api/fhir/resources/encounter)> | Encounter motivating request | | occurrence\[x] | No | dateTime, [Period](/medical-api/fhir/data-types/period), [Timing](/medical-api/fhir/data-types/timing) | Desired time or schedule for use | | authoredOn | No | dateTime | When recorded | | requester | No | Reference\<[Device](/medical-api/fhir/resources/device) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Organization](/medical-api/fhir/resources/organization)> | Who/what is requesting diagnostics | | performerType | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Filler role | | performer | 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) / [HealthcareService](/medical-api/fhir/resources/healthcareservice) / [Patient](/medical-api/fhir/resources/patient) / [Device](/medical-api/fhir/resources/device) / [RelatedPerson](/medical-api/fhir/resources/relatedperson)> | Requested Filler | | reasonCode | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | Coded Reason for request | | reasonReference | No | Reference\<[Condition](/medical-api/fhir/resources/condition) / [Observation](/medical-api/fhir/resources/observation) / [DiagnosticReport](/medical-api/fhir/resources/diagnosticreport) / [DocumentReference](/medical-api/fhir/resources/documentreference)>\[] | Linked Reason for request | | insurance | No | Reference\<[Coverage](/medical-api/fhir/resources/coverage) / [ClaimResponse](/medical-api/fhir/resources/claimresponse)>\[] | Associated insurance coverage | | supportingInfo | No | Reference\\[] | Additional clinical information | | note | No | [Annotation](/medical-api/fhir/data-types/annotation)\[] | Notes or comments | | relevantHistory | No | Reference\<[Provenance](/medical-api/fhir/resources/provenance)>\[] | Request provenance | ## Search Parameters | Name | Type | Description | Expression | | ---------------------- | --------- | ---------------------------------------------------------------------- | ----------------------------------- | | code | token | Code for what is being requested/ordered | DeviceRequest.code | | identifier | token | Business identifier for request/order | DeviceRequest.identifier | | patient | reference | Individual the service is ordered for | DeviceRequest.subject | | encounter | reference | Encounter during which request was created | DeviceRequest.encounter | | authored-on | date | When the request transitioned to being actionable | DeviceRequest.authoredOn | | based-on | reference | Plan/proposal/order fulfilled by this request | DeviceRequest.basedOn | | device | reference | Reference to resource that is being requested/ordered | DeviceRequest.code | | event-date | date | When service should occur | DeviceRequest.occurrence | | group-identifier | token | Composite request this is part of | DeviceRequest.groupIdentifier | | instantiates-canonical | reference | Instantiates FHIR protocol or definition | DeviceRequest.instantiatesCanonical | | instantiates-uri | uri | Instantiates external protocol or definition | DeviceRequest.instantiatesUri | | insurance | reference | Associated insurance coverage | DeviceRequest.insurance | | intent | token | proposal / plan / original-order /reflex-order | DeviceRequest.intent | | performer | reference | Desired performer for service | DeviceRequest.performer | | prior-request | reference | Request takes the place of referenced completed or terminated requests | DeviceRequest.priorRequest | | requester | reference | Who/what is requesting service | DeviceRequest.requester | | status | token | entered-in-error / draft / active /suspended / completed | DeviceRequest.status | | subject | reference | Individual the service is ordered for | DeviceRequest.subject | ## 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 [DeviceRequest](https://www.hl7.org/fhir/StructureDefinition/DeviceRequest).