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

# Task

> A task to be performed.

## Properties

| Name | Required | Type | Description |
| - | - | - | - |
| identifier | No | [Identifier](/medical-api/fhir/data-types/identifier)\[] | Task Instance Identifier |
| instantiatesCanonical | No | canonical | Formal definition of task |
| instantiatesUri | No | uri | Formal definition of task |
| basedOn | No | Reference\<Resource>\[] | Request fulfilled by this task |
| groupIdentifier | No | [Identifier](/medical-api/fhir/data-types/identifier) | Requisition or grouper id |
| partOf | No | Reference\<[Task](/medical-api/fhir/resources/task)>\[] | Composite task |
| status | Yes | code | draft / requested / received / accepted / + |
| statusReason | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Reason for current status |
| businessStatus | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | E.g. "Specimen collected", "IV prepped" |
| intent | Yes | code | unknown / proposal / plan / order / original-order / reflex-order / filler-order / instance-order / option |
| priority | No | code | routine / urgent / asap / stat |
| code | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Task Type |
| description | No | string | Human-readable explanation of task |
| focus | No | Reference\<Resource> | What task is acting on |
| for | No | Reference\<Resource> | Beneficiary of the Task |
| encounter | No | Reference\<[Encounter](/medical-api/fhir/resources/encounter)> | Healthcare event during which this task originated |
| executionPeriod | No | [Period](/medical-api/fhir/data-types/period) | Start and end time of execution |
| authoredOn | No | dateTime | Task Creation Date |
| lastModified | No | dateTime | Task Last Modified Date |
| requester | No | Reference\<[Device](/medical-api/fhir/resources/device) / [Organization](/medical-api/fhir/resources/organization) / [Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [RelatedPerson](/medical-api/fhir/resources/relatedperson)> | Who is asking for task to be done |
| performerType | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | Requested performer |
| owner | 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)> | Responsible individual |
| location | No | Reference\<[Location](/medical-api/fhir/resources/location)> | Where task occurs |
| reasonCode | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Why task is needed |
| reasonReference | No | Reference\<Resource> | Why task is needed |
| insurance | No | Reference\<[Coverage](/medical-api/fhir/resources/coverage) / [ClaimResponse](/medical-api/fhir/resources/claimresponse)>\[] | Associated insurance coverage |
| note | No | [Annotation](/medical-api/fhir/data-types/annotation)\[] | Comments made about the task |
| relevantHistory | No | Reference\<[Provenance](/medical-api/fhir/resources/provenance)>\[] | Key events in history of the Task |
| restriction | No | TaskRestriction | Constraints on fulfillment tasks |
| - 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 |
| - repetitions | No | positiveInt | How many times to repeat |
| - period | No | [Period](/medical-api/fhir/data-types/period) | When fulfillment sought |
| - recipient | No | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Group](/medical-api/fhir/resources/group) / [Organization](/medical-api/fhir/resources/organization)>\[] | For whom is fulfillment sought? |
| input | No | TaskInput | Information used to perform task |
| - 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 |
| - type | Yes | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Label for the input |
| - value\[x] | Yes | base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, [Address](/medical-api/fhir/data-types/address), [Age](/medical-api/fhir/data-types/age), [Annotation](/medical-api/fhir/data-types/annotation), [Attachment](/medical-api/fhir/data-types/attachment), [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), [Coding](/medical-api/fhir/data-types/coding), [ContactPoint](/medical-api/fhir/data-types/contactpoint), [Count](/medical-api/fhir/data-types/count), [Distance](/medical-api/fhir/data-types/distance), [Duration](/medical-api/fhir/data-types/duration), [HumanName](/medical-api/fhir/data-types/humanname), [Identifier](/medical-api/fhir/data-types/identifier), [Money](/medical-api/fhir/data-types/money), [Period](/medical-api/fhir/data-types/period), [Quantity](/medical-api/fhir/data-types/quantity), [Range](/medical-api/fhir/data-types/range), [Ratio](/medical-api/fhir/data-types/ratio), Reference\<>, [SampledData](/medical-api/fhir/data-types/sampleddata), [Signature](/medical-api/fhir/data-types/signature), [Timing](/medical-api/fhir/data-types/timing), [ContactDetail](/medical-api/fhir/data-types/contactdetail), [Contributor](/medical-api/fhir/data-types/contributor), [DataRequirement](/medical-api/fhir/data-types/datarequirement), [Expression](/medical-api/fhir/data-types/expression), [ParameterDefinition](/medical-api/fhir/data-types/parameterdefinition), [RelatedArtifact](/medical-api/fhir/data-types/relatedartifact), [TriggerDefinition](/medical-api/fhir/data-types/triggerdefinition), [UsageContext](/medical-api/fhir/data-types/usagecontext), [Dosage](/medical-api/fhir/data-types/dosage), [Meta](/medical-api/fhir/data-types/meta) | Content to use in performing the task |
| output | No | TaskOutput | Information produced as part of task |
| - 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 |
| - type | Yes | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Label for output |
| - value\[x] | Yes | base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, [Address](/medical-api/fhir/data-types/address), [Age](/medical-api/fhir/data-types/age), [Annotation](/medical-api/fhir/data-types/annotation), [Attachment](/medical-api/fhir/data-types/attachment), [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), [Coding](/medical-api/fhir/data-types/coding), [ContactPoint](/medical-api/fhir/data-types/contactpoint), [Count](/medical-api/fhir/data-types/count), [Distance](/medical-api/fhir/data-types/distance), [Duration](/medical-api/fhir/data-types/duration), [HumanName](/medical-api/fhir/data-types/humanname), [Identifier](/medical-api/fhir/data-types/identifier), [Money](/medical-api/fhir/data-types/money), [Period](/medical-api/fhir/data-types/period), [Quantity](/medical-api/fhir/data-types/quantity), [Range](/medical-api/fhir/data-types/range), [Ratio](/medical-api/fhir/data-types/ratio), Reference\<>, [SampledData](/medical-api/fhir/data-types/sampleddata), [Signature](/medical-api/fhir/data-types/signature), [Timing](/medical-api/fhir/data-types/timing), [ContactDetail](/medical-api/fhir/data-types/contactdetail), [Contributor](/medical-api/fhir/data-types/contributor), [DataRequirement](/medical-api/fhir/data-types/datarequirement), [Expression](/medical-api/fhir/data-types/expression), [ParameterDefinition](/medical-api/fhir/data-types/parameterdefinition), [RelatedArtifact](/medical-api/fhir/data-types/relatedartifact), [TriggerDefinition](/medical-api/fhir/data-types/triggerdefinition), [UsageContext](/medical-api/fhir/data-types/usagecontext), [Dosage](/medical-api/fhir/data-types/dosage), [Meta](/medical-api/fhir/data-types/meta) | Result of output |

## Search Parameters

| Name | Type | Description | Expression |
| - | - | - | - |
| authored-on | date | Search by creation date | Task.authoredOn |
| based-on | reference | Search by requests this task is based on | Task.basedOn |
| business-status | token | Search by business status | Task.businessStatus |
| code | token | Search by task code | Task.code |
| encounter | reference | Search by encounter | Task.encounter |
| focus | reference | Search by task focus | Task.focus |
| group-identifier | token | Search by group identifier | Task.groupIdentifier |
| identifier | token | Search for a task instance by its business identifier | Task.identifier |
| intent | token | Search by task intent | Task.intent |
| modified | date | Search by last modification date | Task.lastModified |
| owner | reference | Search by task owner | Task.owner |
| part-of | reference | Search by task this task is part of | Task.partOf |
| patient | reference | Search by patient | Task.for |
| performer | token | Search by recommended type of performer (e.g., Requester, Performer, Scheduler). | Task.performerType |
| period | date | Search by period Task is/was underway | Task.executionPeriod |
| priority | token | Search by task priority | Task.priority |
| requester | reference | Search by task requester | Task.requester |
| status | token | Search by task status | Task.status |
| subject | reference | Search by subject | Task.for |

## 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 [Task](https://www.hl7.org/fhir/StructureDefinition/Task).


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