# Evidence

Canonical page: https://docs.ovok.com/api/fhir/r4/evidence

The Evidence 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.

These interaction paths describe standard FHIR R4 patterns. Availability can depend on the API capabilities enabled for your Ovok project.

| **Interaction** | **Method** | **Path** |
| --- | --- | --- |
| Read | `GET` | `/fhir/R4/Evidence/[id]` |
| Vread | `GET` | `/fhir/R4/Evidence/[id]/_history/[vid]` |
| Update | `PUT` | `/fhir/R4/Evidence/[id]` |
| Patch | `PATCH` | `/fhir/R4/Evidence/[id]` |
| Delete | `DELETE` | `/fhir/R4/Evidence/[id]` |
| Create | `POST` | `/fhir/R4/Evidence` |
| Search | `GET` | `/fhir/R4/Evidence` |
| History | `GET` | `/fhir/R4/Evidence/[id]/_history` |

## Top-level elements [#top-level-elements]

| **Element** | **Type** | **Cardinality** | **Description** |
| --- | --- | --- | --- |
| <span id="element-id"></span>`id` | [string](/fhir-elements/primitive/string) | `0..1` | Logical id of this artifact |
| <span id="element-meta"></span>`meta` | [Meta](/fhir-elements/complex/meta) | `0..1` | Metadata about the resource |
| <span id="element-implicit-rules"></span>`implicitRules` | [uri](/fhir-elements/primitive/uri) | `0..1` | A set of rules under which this content was created |
| <span id="element-language"></span>`language` | [code](/fhir-elements/primitive/code) | `0..1` | Language of the resource content |
| <span id="element-text"></span>`text` | [Narrative](/fhir-elements/complex/narrative) | `0..1` | Text summary of the resource, for human interpretation |
| <span id="element-contained"></span>`contained` | [Resource](/fhir-elements/foundation/resource) | `0..*` | Contained, inline Resources |
| <span id="element-extension"></span>`extension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Additional content defined by implementations |
| <span id="element-modifier-extension"></span>`modifierExtension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Extensions that cannot be ignored |
| <span id="element-url"></span>`url` | [uri](/fhir-elements/primitive/uri) | `0..1` | Canonical identifier for this evidence, represented as a URI (globally unique) |
| <span id="element-identifier"></span>`identifier` | [Identifier](/fhir-elements/complex/identifier) | `0..*` | Additional identifier for the evidence |
| <span id="element-version"></span>`version` | [string](/fhir-elements/primitive/string) | `0..1` | Business version of the evidence |
| <span id="element-name"></span>`name` | [string](/fhir-elements/primitive/string) | `0..1` | Name for this evidence (computer friendly) |
| <span id="element-title"></span>`title` | [string](/fhir-elements/primitive/string) | `0..1` | Name for this evidence (human friendly) |
| <span id="element-short-title"></span>`shortTitle` | [string](/fhir-elements/primitive/string) | `0..1` | Title for use in informal contexts |
| <span id="element-subtitle"></span>`subtitle` | [string](/fhir-elements/primitive/string) | `0..1` | Subordinate title of the Evidence |
| <span id="element-status"></span>`status` | [code](/fhir-elements/primitive/code) | `1..1` | draft \| active \| retired \| unknown |
| <span id="element-date"></span>`date` | [dateTime](/fhir-elements/primitive/date-time) | `0..1` | Date last changed |
| <span id="element-publisher"></span>`publisher` | [string](/fhir-elements/primitive/string) | `0..1` | Name of the publisher (organization or individual) |
| <span id="element-contact"></span>`contact` | [ContactDetail](/fhir-elements/complex/contact-detail) | `0..*` | Contact details for the publisher |
| <span id="element-description"></span>`description` | [markdown](/fhir-elements/primitive/markdown) | `0..1` | Natural language description of the evidence |
| <span id="element-note"></span>`note` | [Annotation](/fhir-elements/complex/annotation) | `0..*` | Used for footnotes or explanatory notes |
| <span id="element-use-context"></span>`useContext` | [UsageContext](/fhir-elements/complex/usage-context) | `0..*` | The context that the content is intended to support |
| <span id="element-jurisdiction"></span>`jurisdiction` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | Intended jurisdiction for evidence (if applicable) |
| <span id="element-copyright"></span>`copyright` | [markdown](/fhir-elements/primitive/markdown) | `0..1` | Use and/or publishing restrictions |
| <span id="element-approval-date"></span>`approvalDate` | [date](/fhir-elements/primitive/date) | `0..1` | When the evidence was approved by publisher |
| <span id="element-last-review-date"></span>`lastReviewDate` | [date](/fhir-elements/primitive/date) | `0..1` | When the evidence was last reviewed |
| <span id="element-effective-period"></span>`effectivePeriod` | [Period](/fhir-elements/complex/period) | `0..1` | When the evidence is expected to be used |
| <span id="element-topic"></span>`topic` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | The category of the Evidence, such as Education, Treatment, Assessment, etc. |
| <span id="element-author"></span>`author` | [ContactDetail](/fhir-elements/complex/contact-detail) | `0..*` | Who authored the content |
| <span id="element-editor"></span>`editor` | [ContactDetail](/fhir-elements/complex/contact-detail) | `0..*` | Who edited the content |
| <span id="element-reviewer"></span>`reviewer` | [ContactDetail](/fhir-elements/complex/contact-detail) | `0..*` | Who reviewed the content |
| <span id="element-endorser"></span>`endorser` | [ContactDetail](/fhir-elements/complex/contact-detail) | `0..*` | Who endorsed the content |
| <span id="element-related-artifact"></span>`relatedArtifact` | [RelatedArtifact](/fhir-elements/complex/related-artifact) | `0..*` | Additional documentation, citations, etc. |
| <span id="element-exposure-background"></span>`exposureBackground` | [Reference](/fhir-elements/complex/reference) | `1..1` | What population? |
| <span id="element-exposure-variant"></span>`exposureVariant` | [Reference](/fhir-elements/complex/reference) | `0..*` | What exposure? |
| <span id="element-outcome"></span>`outcome` | [Reference](/fhir-elements/complex/reference) | `0..*` | What outcome? |

## Resource-specific search parameters [#resource-specific-search-parameters]

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

## Reference [#reference]

Official FHIR R4 spec: [Evidence](https://hl7.org/fhir/R4/evidence.html).  
Maturity: Draft (FMM 0).
