---
title: "GET /cart/{cart_id}/promotions"
method: GET
path: "/cart/{cart_id}/promotions"
---

# GET /cart/{cart_id}/promotions

`GET /cart/{cart_id}/promotions`

## Request

- Base URL: `https://developers.whmcs.com/api/v2`
- URL: `https://developers.whmcs.com/api/v2/cart/{cart_id}/promotions`
- Auth: none declared

Get the currently-applied promotion codes.

## Path parameters

- `cart_id` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Success

- object
  - `data` Promotion[], required
    - `code` string, nullable, required
    - `type` string, nullable
    - `value` number, float, nullable: Monetary amount or discount percentage
    - `is_recurring` boolean, nullable
    - `number_of_recurring` integer, nullable: maximum number of times the promotion code will be applied if set

## Other responses

- `404`: Entity Not Found
- `default`: General Error

---

[API](https://skmtc.dev/whmcs/apis/whmcs-api.md) - [All operations](https://skmtc.dev/whmcs/apis/whmcs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whmcs/apis/whmcs-api/revisions/bd3848ddbc3f?raw)