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

# Consent

> A record of a healthcare consumer’s  choices, which permits or denies identified recipient(s) or recipient role(s) to perform one or more actions within a given policy context, for specific purposes and periods of time.

## Properties

| Name                | Required | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Description                                                        |
| ------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| identifier          | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                                                                                                                                                                                                                                                        | Identifier for this record (external references)                   |
| status              | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                                                                            | draft / proposed / active / rejected / inactive / entered-in-error |
| scope               | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                 | Which of the four areas this resource covers (extensible)          |
| category            | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                              | Classification of the consent statement - for indexing/retrieval   |
| patient             | No       | Reference\<[Patient](/medical-api/fhir/resources/patient)>                                                                                                                                                                                                                                                                                                                                                                                                      | Who the consent applies to                                         |
| dateTime            | No       | dateTime                                                                                                                                                                                                                                                                                                                                                                                                                                                        | When this Consent was created or indexed                           |
| performer           | No       | Reference\<[Organization](/medical-api/fhir/resources/organization) / [Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole)>\[]                                                                                                                                             | Who is agreeing to the policy and rules                            |
| organization        | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>\[]                                                                                                                                                                                                                                                                                                                                                                                         | Custodian of the consent                                           |
| source\[x]          | No       | [Attachment](/medical-api/fhir/data-types/attachment), Reference\<[Consent](/medical-api/fhir/resources/consent) / [DocumentReference](/medical-api/fhir/resources/documentreference) / [Contract](/medical-api/fhir/resources/contract) / [QuestionnaireResponse](/medical-api/fhir/resources/questionnaireresponse)>                                                                                                                                          | Source from which this consent is taken                            |
| policy              | No       | ConsentPolicy                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Policies covered by this consent                                   |
| - 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             |
| - authority         | No       | uri                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Enforcement source for policy                                      |
| - uri               | No       | uri                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Specific policy covered by this consent                            |
| policyRule          | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                 | Regulation that this consents to                                   |
| verification        | No       | ConsentVerification                                                                                                                                                                                                                                                                                                                                                                                                                                             | Consent Verified by patient or family                              |
| - 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             |
| - verified          | Yes      | boolean                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Has been verified                                                  |
| - verifiedWith      | No       | Reference\<[Patient](/medical-api/fhir/resources/patient) / [RelatedPerson](/medical-api/fhir/resources/relatedperson)>                                                                                                                                                                                                                                                                                                                                         | Person who verified                                                |
| - verificationDate  | No       | dateTime                                                                                                                                                                                                                                                                                                                                                                                                                                                        | When consent verified                                              |
| provision           | No       | ConsentProvision                                                                                                                                                                                                                                                                                                                                                                                                                                                | Constraints to the base Consent.policyRule                         |
| - 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              | No       | code                                                                                                                                                                                                                                                                                                                                                                                                                                                            | deny / permit                                                      |
| - period            | No       | [Period](/medical-api/fhir/data-types/period)                                                                                                                                                                                                                                                                                                                                                                                                                   | Timeframe for this rule                                            |
| - actor             | No       | ConsentProvisionActor                                                                                                                                                                                                                                                                                                                                                                                                                                           | Who/what controlled by this rule (or group, by role)               |
| - 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             |
| - role              | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                 | How the actor is involved                                          |
| - reference         | Yes      | Reference\<[Device](/medical-api/fhir/resources/device) / [Group](/medical-api/fhir/resources/group) / [CareTeam](/medical-api/fhir/resources/careteam) / [Organization](/medical-api/fhir/resources/organization) / [Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole)> | Resource for the actor (or group, by role)                         |
| - action            | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                              | Actions controlled by this rule                                    |
| - securityLabel     | No       | [Coding](/medical-api/fhir/data-types/coding)\[]                                                                                                                                                                                                                                                                                                                                                                                                                | Security Labels that define affected resources                     |
| - purpose           | No       | [Coding](/medical-api/fhir/data-types/coding)\[]                                                                                                                                                                                                                                                                                                                                                                                                                | Context of activities covered by this rule                         |
| - class             | No       | [Coding](/medical-api/fhir/data-types/coding)\[]                                                                                                                                                                                                                                                                                                                                                                                                                | e.g. Resource Type, Profile, CDA, etc.                             |
| - code              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                              | e.g. LOINC or SNOMED CT code, etc. in the content                  |
| - dataPeriod        | No       | [Period](/medical-api/fhir/data-types/period)                                                                                                                                                                                                                                                                                                                                                                                                                   | Timeframe for data controlled by this rule                         |
| - data              | No       | ConsentProvisionData                                                                                                                                                                                                                                                                                                                                                                                                                                            | Data controlled by this rule                                       |
| - 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             |
| - meaning           | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                                                                            | instance / related / dependents / authoredby                       |
| - reference         | Yes      | Reference\<Resource>                                                                                                                                                                                                                                                                                                                                                                                                                                            | The actual data reference                                          |
| - provision         | No       | \[]                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Nested Exception Rules                                             |

## Search Parameters

| Name             | Type      | Description                                                                            | Expression                        |
| ---------------- | --------- | -------------------------------------------------------------------------------------- | --------------------------------- |
| date             | date      | When this Consent was created or indexed                                               | Consent.dateTime                  |
| identifier       | token     | Identifier for this record (external references)                                       | Consent.identifier                |
| patient          | reference | Who the consent applies to                                                             | Consent.patient                   |
| action           | token     | Actions controlled by this rule                                                        | Consent.provision.action          |
| actor            | reference | Resource for the actor (or group, by role)                                             | Consent.provision.actor.reference |
| category         | token     | Classification of the consent statement - for indexing/retrieval                       | Consent.category                  |
| consentor        | reference | Who is agreeing to the policy and rules                                                | Consent.performer                 |
| data             | reference | The actual data reference                                                              | Consent.provision.data.reference  |
| organization     | reference | Custodian of the consent                                                               | Consent.organization              |
| period           | date      | Timeframe for this rule                                                                | Consent.provision.period          |
| purpose          | token     | Context of activities covered by this rule                                             | Consent.provision.purpose         |
| scope            | token     | Which of the four areas this resource covers (extensible)                              | Consent.scope                     |
| security-label   | token     | Security Labels that define affected resources                                         | Consent.provision.securityLabel   |
| source-reference | reference | Search by reference to a Consent, DocumentReference, Contract or QuestionnaireResponse | Consent.source                    |
| status           | token     | draft / proposed / active / rejected / inactive / entered-in-error                     | Consent.status                    |

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