---
title: "Get Cart Promotions for a Customer"
method: GET
path: "/api_gateway/v1/promotions/customer/109943742?includeRedemptions=true&includeSupplementaryPromotions=true"
---

# Get Cart Promotions for a Customer

`GET /api_gateway/v1/promotions/customer/109943742?includeRedemptions=true&includeSupplementaryPromotions=true`

This API is used to retrieve the cart promotions tagged to a particular customer based on the user ID. This returns cart promotions issued to the customer or POS promotions which are tagged to the customer's tier or supplementary programs.

## Query parameters

- `includeRedemptions` boolean
- `includeSupplementaryPromotions` boolean

## Response `200`

200

- union
  - object
    - `data` object[]
      - `promotionId` string
      - `promotionName` string
      - `validTill` integer
      - `customerId` integer
      - `earnedType` string
      - `earnedStatus` string
      - `promotionStatus` string
      - `supplementaryCriteria` object
        - `loyaltyProgramId` integer
        - `programType` string
        - `partnerProgramId` integer
      - `applicationMode` string
      - `customFieldValues` object
        - `t&c` string
        - `Test_Cap` string
        - `Field` string
        - `image_url` string
        - `partner 1 liability value` string
      - `restrictions` object
        - `Cart` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
        - `Customer` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
      - `eventTime` integer
    - `errors` unknown[]
      - unknown
  - object
    - `data` object[]
      - `earnedPromotionId` string
      - `promotionId` string
      - `promotionName` string
      - `validTill` integer
      - `unlockedDate` integer
      - `customerId` integer
      - `earnedType` string
      - `earnedStatus` string
      - `promotionStatus` string
      - `mileStoneId` integer
      - `targetGroupId` integer
      - `applicationMode` string
      - `redeemableFrom` integer
      - `customFieldValues` object
        - `t&c` string
        - `Test_Cap` string
        - `Field` string
        - `image_url` string
        - `partner 1 liability value` string
      - `restrictions` object
        - `Cart` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
        - `Customer` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
      - `eventTime` integer
    - `errors` unknown[]
      - unknown
  - object
    - `data` object[]
      - `promotionId` string
      - `promotionName` string
      - `validTill` integer
      - `customerId` integer
      - `earnedType` string
      - `earnedStatus` string
      - `promotionStatus` string
      - `supplementaryCriteria` object
        - `loyaltyProgramId` integer
        - `programType` string
        - `partnerProgramId` integer
      - `applicationMode` string
      - `customFieldValues` object
        - `t&c` string
        - `Test_Cap` string
        - `Field` string
        - `image_url` string
        - `partner 1 liability value` string
      - `eventTime` integer
    - `errors` unknown[]
      - unknown
  - object
    - `data` object[]
      - `earnedPromotionId` string
      - `promotionId` string
      - `promotionName` string
      - `validTill` integer
      - `unlockedDate` integer
      - `customerId` integer
      - `earnedType` string
      - `earnedStatus` string
      - `promotionStatus` string
      - `mileStoneId` integer
      - `targetGroupId` integer
      - `applicationMode` string
      - `redeemableFrom` integer
      - `customFieldValues` object
        - `t&c` string
        - `Test_Cap` string
        - `Field` string
        - `image_url` string
        - `partner 1 liability value` string
      - `eventTime` integer
    - `errors` unknown[]
      - unknown
  - object
    - `data` object[]
      - `earnedPromotionId` string
      - `promotionId` string
      - `promotionName` string
      - `validTill` integer
      - `unlockedDate` integer
      - `customerId` integer
      - `earnedType` string
      - `earnedStatus` string
      - `promotionStatus` string
      - `applicationMode` string
      - `redeemableFrom` integer
      - `customFieldValues` object
      - `restrictions` object
        - `Customer` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
        - `Cart` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
        - `Promotion` object[]
          - `kpi` string
          - `maxLimit` string
          - `remainingRedemption` string
      - `eventTime` integer
    - `errors` unknown[]
      - unknown

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)