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

# ServiceRequest

> A record of a request for service such as diagnostic investigations, treatments, or operations to be performed.

## Properties

| Name                  | Required | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Description                                                                                                  |
| --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| identifier            | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                   | Identifiers assigned to this order                                                                           |
| instantiatesCanonical | No       | canonical\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Instantiates FHIR protocol or definition                                                                     |
| instantiatesUri       | No       | uri\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Instantiates external protocol or definition                                                                 |
| basedOn               | No       | Reference\<[CarePlan](/medical-api/fhir/resources/careplan) / [ServiceRequest](/medical-api/fhir/resources/servicerequest) / [MedicationRequest](/medical-api/fhir/resources/medicationrequest)>\[]                                                                                                                                                                                                                                                                                        | What request fulfills                                                                                        |
| replaces              | No       | Reference\<[ServiceRequest](/medical-api/fhir/resources/servicerequest)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                | What request replaces                                                                                        |
| requisition           | No       | [Identifier](/medical-api/fhir/data-types/identifier)                                                                                                                                                                                                                                                                                                                                                                                                                                      | Composite Request ID                                                                                         |
| status                | Yes      | 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 |
| category              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                         | Classification of service                                                                                    |
| priority              | No       | code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | routine / urgent / asap / stat                                                                               |
| doNotPerform          | No       | boolean                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | True if service/procedure should not be performed                                                            |
| code                  | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                                            | What is being requested/ordered                                                                              |
| orderDetail           | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                         | Additional order information                                                                                 |
| quantity\[x]          | No       | [Quantity](/medical-api/fhir/data-types/quantity), [Ratio](/medical-api/fhir/data-types/ratio), [Range](/medical-api/fhir/data-types/range)                                                                                                                                                                                                                                                                                                                                                | Service amount                                                                                               |
| 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)>                                                                                                                                                                                                                                                                                  | Individual or Entity the service is ordered for                                                              |
| encounter             | No       | Reference\<[Encounter](/medical-api/fhir/resources/encounter)>                                                                                                                                                                                                                                                                                                                                                                                                                             | Encounter in which the request was created                                                                   |
| occurrence\[x]        | No       | dateTime, [Period](/medical-api/fhir/data-types/period), [Timing](/medical-api/fhir/data-types/timing)                                                                                                                                                                                                                                                                                                                                                                                     | When service should occur                                                                                    |
| asNeeded\[x]          | No       | boolean, [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                                   | Preconditions for service                                                                                    |
| authoredOn            | No       | dateTime                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Date request signed                                                                                          |
| requester             | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Organization](/medical-api/fhir/resources/organization) / [Patient](/medical-api/fhir/resources/patient) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Device](/medical-api/fhir/resources/device)>                                                                                                                            | Who/what is requesting service                                                                               |
| performerType         | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                                            | Performer 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 performer                                                                                          |
| locationCode          | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                         | Requested location                                                                                           |
| locationReference     | No       | Reference\<[Location](/medical-api/fhir/resources/location)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                            | Requested location                                                                                           |
| reasonCode            | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                         | Explanation/Justification for procedure or service                                                           |
| 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)>\[]                                                                                                                                                                                                                         | Explanation/Justification for service or service                                                             |
| insurance             | No       | Reference\<[Coverage](/medical-api/fhir/resources/coverage) / [ClaimResponse](/medical-api/fhir/resources/claimresponse)>\[]                                                                                                                                                                                                                                                                                                                                                               | Associated insurance coverage                                                                                |
| supportingInfo        | No       | Reference\<Resource>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Additional clinical information                                                                              |
| specimen              | No       | Reference\<[Specimen](/medical-api/fhir/resources/specimen)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                            | Procedure Samples                                                                                            |
| bodySite              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                         | Location on Body                                                                                             |
| note                  | No       | [Annotation](/medical-api/fhir/data-types/annotation)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                   | Comments                                                                                                     |
| patientInstruction    | No       | string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Patient or consumer-oriented instructions                                                                    |
| relevantHistory       | No       | Reference\<[Provenance](/medical-api/fhir/resources/provenance)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                        | Request provenance                                                                                           |

## Search Parameters

| Name                   | Type      | Description                                                                                                  | Expression                           |
| ---------------------- | --------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------ |
| code                   | token     | What is being requested/ordered                                                                              | ServiceRequest.code                  |
| identifier             | token     | Identifiers assigned to this order                                                                           | ServiceRequest.identifier            |
| patient                | reference | Search by subject - a patient                                                                                | ServiceRequest.subject               |
| encounter              | reference | An encounter in which this request is made                                                                   | ServiceRequest.encounter             |
| authored               | date      | Date request signed                                                                                          | ServiceRequest.authoredOn            |
| based-on               | reference | What request fulfills                                                                                        | ServiceRequest.basedOn               |
| body-site              | token     | Where procedure is going to be done                                                                          | ServiceRequest.bodySite              |
| category               | token     | Classification of service                                                                                    | ServiceRequest.category              |
| instantiates-canonical | reference | Instantiates FHIR protocol or definition                                                                     | ServiceRequest.instantiatesCanonical |
| instantiates-uri       | uri       | Instantiates external protocol or definition                                                                 | ServiceRequest.instantiatesUri       |
| intent                 | token     | proposal / plan / directive / order / original-order / reflex-order / filler-order / instance-order / option | ServiceRequest.intent                |
| occurrence             | date      | When service should occur                                                                                    | ServiceRequest.occurrence            |
| order-details          | token     | Order detail                                                                                                 | ServiceRequest.orderDetail.text      |
| performer              | reference | Requested performer                                                                                          | ServiceRequest.performer             |
| performer-type         | token     | Performer role                                                                                               | ServiceRequest.performerType         |
| priority               | token     | routine / urgent / asap / stat                                                                               | ServiceRequest.priority              |
| replaces               | reference | What request replaces                                                                                        | ServiceRequest.replaces              |
| requester              | reference | Who/what is requesting service                                                                               | ServiceRequest.requester             |
| requisition            | token     | Composite Request ID                                                                                         | ServiceRequest.requisition           |
| specimen               | reference | Specimen to be tested                                                                                        | ServiceRequest.specimen              |
| status                 | token     | draft / active / on-hold / revoked / completed / entered-in-error / unknown                                  | ServiceRequest.status                |
| subject                | reference | Search by subject                                                                                            | ServiceRequest.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 [ServiceRequest](https://www.hl7.org/fhir/StructureDefinition/ServiceRequest).
