# Retrieve active promotions in cart

Use this method to list all promotions applied to products added to the cart.

## Requirements

This method requires you to set a specific partner using [**setPartner**](/channel-manager-api/channel-manager-api/api-2.1/json-rpc-2.1/reference/partner/set-partner.md).

## Request parameters

<table><thead><tr><th width="119.7999267578125">Parameter</th><th>Type / Description</th></tr></thead><tbody><tr><td><code>sessionID</code></td><td><p><strong>Required (string)</strong></p><p>Session identifier, output of the Login method. An exception is thrown if the values are incorrect.</p></td></tr></tbody></table>

### Request sample

```php
<?php

require ('PATH_TO_AUTH');  // Authentication example: https://knowledgecenter.avangate.com/Integration/Channel_Manager_API/JSON-RPC/02Authentication
require ('PATH_TO_setPartner'); // setPartner example: https://knowledgecenter.avangate.com/Integration/Channel_Manager_API/JSON-RPC/06Reference/Partner/00Set_partner

$jsonRpcRequest = array (
  'jsonrpc' => '2.0',
  'id' => $i++,
  'method' => 'getPromotions',
  'params' => array($sessionID)
);
var_dump (callRPC((Object)$jsonRpcRequest, $host));
```

## Response parameters

<table><thead><tr><th width="284.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>Promotion</code></td><td><p><strong>Array of objects</strong></p><p>Details below.</p></td></tr><tr><td><code>Promotion.Name</code></td><td><strong>String</strong><br>Promotion name</td></tr><tr><td><code>Promotion.Description</code></td><td><strong>String</strong><br>Promotion description</td></tr><tr><td><code>Promotion.StartDate</code></td><td><strong>String</strong><br>Promotion start date. NULL for promotions that start immediately after they're created.</td></tr><tr><td><code>Promotion.EndDate</code></td><td><strong>String</strong><br>Ending date. The date when you set the promotion to end. NULL for promotions that are active indefinitely.</td></tr><tr><td><code>Promotion.MaximumOrdersNumber</code></td><td><strong>Int</strong><br>When the maximum number of orders is reached the promotion stops. NULL for unlimited number of orders.</td></tr><tr><td><code>Promotion.MaximumQuantity</code></td><td><strong>Int</strong><br>Discount applies to a specific number of products, smaller than the maximum defined quantity. NULL for unlimited number of units. Any extra quantity added to the cart will be sold at full price.</td></tr><tr><td><code>Promotion.InstantDiscount</code></td><td><strong>Boolean</strong><br>Selecting the instant discount option auto-applies the discount for ALL the selected products for all shoppers, without the need to enter the discount coupon.</td></tr><tr><td><code>Promotion.Coupon</code></td><td><strong>String</strong><br>Promotion coupon/voucher.</td></tr><tr><td><code>Promotion.DiscountLabel</code></td><td><strong>String</strong><br>Set discounts as percentage from the product price or as a fixed amount in the chosen currency.</td></tr></tbody></table>

## Errors

<table><thead><tr><th width="185.800048828125">Error</th><th>Description</th></tr></thead><tbody><tr><td><strong>EMPTY_CART</strong></td><td>The shopping cart is empty.</td></tr><tr><td><strong>NO_PROMOTIONS</strong></td><td>There are no promotions applied to the current shopping cart.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.2checkout.com/channel-manager-api/channel-manager-api/api-2.1/json-rpc-2.1/reference/promotions/retrieve-active-promotions-in-cart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.