---
title: "Patient Timelines for URSA-PHARM Concepts"
slug: "pharm-key-concepts-patient-timelines-for-ursa-pharm-concepts"
updated: 2023-05-31T19:38:12Z
published: 2023-05-31T19:38:12Z
canonical: "docs.ursahealth.com/pharm-key-concepts-patient-timelines-for-ursa-pharm-concepts"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ursahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Patient Timelines for URSA-PHARM Concepts

## Definition

One record per patient - period during which the patient was alive and had one or more outpatient medication fills in the previous 12 months.

## Purpose

Used in the URSA-PHARM module to identify qualifying patients for inclusion in module-related concepts.

## Related objects

- [Patient Timelines Master for URSA-CORE Concepts](/v1/docs/core-objects-patient-timelines-master-for-ursa-core-concepts)
- [Outpatient Medication Fills Aggregator for URSA-PHARM Concepts](/v1/docs/pharm-objects-outpatient-medication-fills-aggregator-for-ursa-pharm-concepts)
- [Targeted Medication Fills with Medication Therapy Episodes](/v1/docs/pharm-objects-targeted-medication-fills-with-medication-therapy-episodes)

## Detailed narrative of logic

1. This logic begins with the URSA-CORE Timeline Master synthetic object which provides the framework of one record per patient timeline period, around which additional module-specific concepts are layered.
2. Next, the Outpatient Medication Fills Aggregator for URSA-PHARM Concepts is added to the timeline to flag outpatient pharmacy fills occurring in the previous 12 months, represented in the timeline as events.
3. Then, the Targeted Medication Fills with Medication Therapy Episodes object is added to the timeline to flag claims for opioid fills in the past 6 and 12 months, both represented in the timeline as events.
4. Next, the Targeted Medication Fills with Medication Therapy Episodes object is added to the timeline to flag active medication therapy periods for targeted medications, represented in the timeline as a potentially-overlapping interval.
5. Finally, the Outpatient Medication Fills Aggregator for URSA-PHARM Concepts is added to calculated a cumulative of total plan and patient paid amounts in the current calendar year, represented in the timeline as a potentially-overlapping interval.