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

# ResearchDefinition

> The ResearchDefinition resource describes the conditional state (population and any exposures being compared within the population) and outcome (if specified) that the knowledge (evidence, assertion, recommendation) is about.

## Properties

| Name | Required | Type | Description |
| - | - | - | - |
| url | No | uri | Canonical identifier for this research definition, represented as a URI (globally unique) |
| identifier | No | [Identifier](https://docs.metriport.com/medical-api/fhir/data-types/identifier.md)\[] | Additional identifier for the research definition |
| version | No | string | Business version of the research definition |
| name | No | string | Name for this research definition (computer friendly) |
| title | No | string | Name for this research definition (human friendly) |
| shortTitle | No | string | Title for use in informal contexts |
| subtitle | No | string | Subordinate title of the ResearchDefinition |
| status | Yes | code | draft / active / retired / unknown |
| experimental | No | boolean | For testing purposes, not real usage |
| subject\[x] | No | [CodeableConcept](https://docs.metriport.com/medical-api/fhir/data-types/codeableconcept.md), Reference\<[Group](https://docs.metriport.com/medical-api/fhir/resources/group)> | E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device |
| date | No | dateTime | Date last changed |
| publisher | No | string | Name of the publisher (organization or individual) |
| contact | No | [ContactDetail](https://docs.metriport.com/medical-api/fhir/data-types/contactdetail.md)\[] | Contact details for the publisher |
| description | No | markdown | Natural language description of the research definition |
| comment | No | string\[] | Used for footnotes or explanatory notes |
| useContext | No | [UsageContext](https://docs.metriport.com/medical-api/fhir/data-types/usagecontext.md)\[] | The context that the content is intended to support |
| jurisdiction | No | [CodeableConcept](https://docs.metriport.com/medical-api/fhir/data-types/codeableconcept.md)\[] | Intended jurisdiction for research definition (if applicable) |
| purpose | No | markdown | Why this research definition is defined |
| usage | No | string | Describes the clinical usage of the ResearchDefinition |
| copyright | No | markdown | Use and/or publishing restrictions |
| approvalDate | No | date | When the research definition was approved by publisher |
| lastReviewDate | No | date | When the research definition was last reviewed |
| effectivePeriod | No | [Period](https://docs.metriport.com/medical-api/fhir/data-types/period.md) | When the research definition is expected to be used |
| topic | No | [CodeableConcept](https://docs.metriport.com/medical-api/fhir/data-types/codeableconcept.md)\[] | The category of the ResearchDefinition, such as Education, Treatment, Assessment, etc. |
| author | No | [ContactDetail](https://docs.metriport.com/medical-api/fhir/data-types/contactdetail.md)\[] | Who authored the content |
| editor | No | [ContactDetail](https://docs.metriport.com/medical-api/fhir/data-types/contactdetail.md)\[] | Who edited the content |
| reviewer | No | [ContactDetail](https://docs.metriport.com/medical-api/fhir/data-types/contactdetail.md)\[] | Who reviewed the content |
| endorser | No | [ContactDetail](https://docs.metriport.com/medical-api/fhir/data-types/contactdetail.md)\[] | Who endorsed the content |
| relatedArtifact | No | [RelatedArtifact](https://docs.metriport.com/medical-api/fhir/data-types/relatedartifact.md)\[] | Additional documentation, citations, etc. |
| library | No | canonical\[] | Logic used by the ResearchDefinition |
| population | Yes | Reference\<[ResearchElementDefinition](https://docs.metriport.com/medical-api/fhir/resources/researchelementdefinition)> | What population? |
| exposure | No | Reference\<[ResearchElementDefinition](https://docs.metriport.com/medical-api/fhir/resources/researchelementdefinition)> | What exposure? |
| exposureAlternative | No | Reference\<[ResearchElementDefinition](https://docs.metriport.com/medical-api/fhir/resources/researchelementdefinition)> | What alternative exposure state? |
| outcome | No | Reference\<[ResearchElementDefinition](https://docs.metriport.com/medical-api/fhir/resources/researchelementdefinition)> | What outcome? |

## Search Parameters

| Name | Type | Description | Expression |
| - | - | - | - |
| composed-of | reference | What resource is being referenced | ResearchDefinition.relatedArtifact |
| context | token | A use context assigned to the research definition | ResearchDefinition.useContext.value |
| context-quantity | quantity | A quantity- or range-valued use context assigned to the research definition | ResearchDefinition.useContext.value |
| context-type | token | A type of use context assigned to the research definition | ResearchDefinition.useContext.code |
| date | date | The research definition publication date | ResearchDefinition.date |
| depends-on | reference | What resource is being referenced | ResearchDefinition.relatedArtifact |
| derived-from | reference | What resource is being referenced | ResearchDefinition.relatedArtifact |
| description | string | The description of the research definition | ResearchDefinition.description |
| effective | date | The time during which the research definition is intended to be in use | ResearchDefinition.effectivePeriod |
| identifier | token | External identifier for the research definition | ResearchDefinition.identifier |
| jurisdiction | token | Intended jurisdiction for the research definition | ResearchDefinition.jurisdiction |
| name | string | Computationally friendly name of the research definition | ResearchDefinition.name |
| predecessor | reference | What resource is being referenced | ResearchDefinition.relatedArtifact |
| publisher | string | Name of the publisher of the research definition | ResearchDefinition.publisher |
| status | token | The current status of the research definition | ResearchDefinition.status |
| successor | reference | What resource is being referenced | ResearchDefinition.relatedArtifact |
| title | string | The human-friendly name of the research definition | ResearchDefinition.title |
| topic | token | Topics associated with the ResearchDefinition | ResearchDefinition.topic |
| url | uri | The uri that identifies the research definition | ResearchDefinition.url |
| version | token | The business version of the research definition | ResearchDefinition.version |
| context-type-quantity | composite | A use context type and quantity- or range-based value assigned to the research definition | ResearchDefinition.useContext |
| context-type-value | composite | A use context type and value assigned to the research definition | ResearchDefinition.useContext |

## Inherited Properties

| Name | Required | Type | Description |
| - | - | - | - |
| id | No | string | Logical id of this artifact |
| meta | No | [Meta](https://docs.metriport.com/medical-api/fhir/data-types/meta.md) | 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](https://docs.metriport.com/medical-api/fhir/data-types/narrative.md) | Text summary of the resource, for human interpretation |
| contained | No | Resource\[] | Contained, inline Resources |
| extension | No | [Extension](https://docs.metriport.com/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| modifierExtension | No | [Extension](https://docs.metriport.com/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored |

To view the FHIR specification for this resource, see [ResearchDefinition](https://www.hl7.org/fhir/StructureDefinition/ResearchDefinition).


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