---
schema_version: "1"
id: 9bc634dda0d731cc4b5ffcf8ccd2d735c5e2bad31c57c3a9e9cf33c58d047c13
title: FormularyItem
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/sforce_api_objects_formularyitem.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_objects_formularyitem.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 81eb377c86913b66e1236ad103e5316f673c2f706643b9d9daac0c0ae406c44d
description: Represents details of products within the formulary, including the drug tier, coverage, and copay. This object is available in API version 65.0 and later.
---
# FormularyItem

Represents details of products within the formulary, including the drug tier, coverage, and copay. This object is available in API version 65.0 and later.

![Important](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### CopayAmount

- **Type**: double
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The copayment amount for the product within the formulary.

### Description

- **Type**: textarea
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The additional details of the formulary product record.

### EffectiveEndDate

- **Type**: date
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The effective end date of the product within the formulary.

### EffectiveStartDate

- **Type**: date
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The effective start date of the product within the formulary.

### FormularyId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort
- **Description**: The ID of the parent formulary record associated with the formulary item.
    
    This field is a relationship field.
- **Relationship Name**: Formulary
- **Relationship Type**: Master-detail
- **Refers To**: Formulary (the master object)

### HasQuantityLimit

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Indicates whether the product within the formulary has a quantity limit (true) or not (false).
- **Default value**: false

### ItemId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort, Update
- **Description**: The ID of the product associated with the formulary.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Item
- **Refers To**: Product2

### LastReferencedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.

### LastViewedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The timestamp when the current user last viewed this record or list view.

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: The name of the formulary item.

### PriorAuthorizationRequiredType

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Specifies the type of prior authorization required for the product within the formulary.

### QuantityLimitDescription

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The detailed description of quantity limits the formulary imposes on a product. This may include a rolling dispense limit, maximum daily, or therapy days for a time period.

### SourceSystemIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The identifier of the record in the source system.

### SourceSystemName

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The name of the system from which data is loaded into the object.

### Status

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Specifies the status of the product within the formulary.

### StepTherapyLimitType

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Specifies the type of step therapy required for the product within the formulary.

### TierType

- **Type**: picklist
- **Properties**: Create, Filter, Group, Sort, Update
- **Description**: Specifies the tier of the product within the formulary.

### TotalCoveredLifeCount

- **Type**: double
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The total number of patients covered for a product within the formulary.

### TotalCoveredPharmacyLifeCount

- **Type**: double
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The total number of pharmacy lives covered for a product within the formulary.

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

[FormularyItemFeed](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[FormularyItemHistory](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")

History is available for tracked fields of the object.