---
schema_version: "1"
id: a84c0b981a9f34fb4edabbf401009937de4c63dd9f8099d79a7733f1c0ebc2c8
title: Promotion Evaluation and Execution API
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/global_promotions_management_run_pricing_eval_api.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.global_promotions_management_run_pricing_eval_api.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: a86333f977e7906799f375f1a7d575a0ccb0de2bc242a5548282b59b0370d5e5
description: The Promotion Evaluation and Execution API evaluates cart details and returns the adjusted price of cart and line items after applying eligible promotions based on the selected promotion evaluation method.
products:
  - Marketing
release: "264"
---
# Promotion Evaluation and Execution API

The Promotion Evaluation and Execution API evaluates cart details and returns the adjusted price of cart and line items after applying eligible promotions based on the selected promotion evaluation method.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>,&nbsp;<strong>Unlimited</strong>, and&nbsp;<strong>Developer</strong>&nbsp;Editions with Real-Time Offer Management</td></tr></tbody></table>

Show customers adjusted prices by applying promotional discounts with a evaluation method that fits your business needs.

For evaluation, a parent group is created for each rule library. Promotions within this group are organized into three categories based on their application: line-level, cross-line, or cart-level. The Promotion Evaluation API takes the cart details and available coupons, and then sequentially applies all relevant discounts based on the configured evaluation method to determine the final adjusted price. When evaluating an item for promotions, the API scans 5 levels of the product’s category hierarchy before applying the right promotion based on the selected evaluation method.

The API response provides a complete breakdown of the discounted cart, including the final adjusted total price, the adjusted price for each line item, and a list of any non-pricing rewards available. If a cart contains a product that doesn't exist in the Salesforce catalog, the API ignores the unsynced products while evaluating line-level and cross line level promotions and applies the eligible promotions for the cart.

The API uses the sum of discounted line amounts as the transactionAmount. To include additional charges, add those in the pricing procedure that’s associated with the promotion group. See [Create a Pricing Procedure for Promotion Evaluation and Execution](https://help.salesforce.com/s/articleView?id=mktg.global_promotions_management_setup_eval_pricing.htm&language=en_US).