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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.