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


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