---
title: "Get Cart Promotions for a particular till"
method: GET
path: "/api_gateway/v1/promotions/till/{tillId}"
---

# Get Cart Promotions for a particular till

`GET /api_gateway/v1/promotions/till/{tillId}`

This API can be used to fetch the Cart promotions for a particular till

## Path parameters

- `tillId` string, required

## Request body

- object
  - `tillId` integer — Unique id assigned to a till

## Response `200`

200

- object
  - `data` object[]
    - `id` string
    - `name` string
    - `orgId` integer
    - `priority` integer
    - `active` boolean
    - `messageLabel` string
    - `type` string
    - `timeCriteria` object
      - `startTime` object
        - `hour` integer
        - `minute` integer
        - `second` integer
        - `nano` integer
      - `durationInHours` integer
      - `repeatFrequency` string
      - `weeklyValues` string[]
      - `monthlyDayValues` integer[]
    - `storeCriteria` object
      - `type` string
      - `values` integer[]
      - `operator` string
    - `supplementaryCriteria` object
      - `loyaltyProgramId` integer
      - `programType` string
      - `partnerProgramId` integer
    - `condition` object
      - `type` string
      - `cartCondition` object
        - `kpi` string
        - `operator` string
        - `value` integer
      - `productCondition` object
        - `criteriaList` object[]
          - `entity` string
          - `operator` string
          - `values` string[]
          - `attributeName` string
        - `kpi` string
        - `value` integer
        - `operator` string
      - `comboProductCondition` object
        - `productConditions` object[]
          - `criteriaList` object[]
            - `entity` string
            - `operator` string
            - `values` string[]
            - `attributeName` string
          - `kpi` string
          - `value` integer
          - `operator` string
      - `tenderCondition` object
        - `type` string
        - `identifier` string
        - `tenderModes` object[]
          - `type` string
          - `identifiers` string[]
        - `condition` string
    - `action` object
      - `type` string
      - `cartBasedAction` object
        - `type` string
        - `value` integer
      - `productBasedAction` object
        - `productBasedCondition` object
          - `type` string
          - `cartCondition` object
            - `kpi` string
            - `operator` string
            - `value` integer
          - `productCondition` object
            - `criteriaList` object[]
              - …
            - `kpi` string
            - `value` integer
            - `operator` string
          - `comboProductCondition` object
            - `productConditions` object[]
              - …
          - `tenderCondition` object
            - `type` string
            - `identifier` string
            - `tenderModes` object[]
              - …
            - `condition` string
        - `type` string
        - `value` integer
        - `includeItemsFromConditionSet` boolean
      - `fixedPriceAction` object
        - `productBasedCondition` object
          - `type` string
          - `cartCondition` object
            - `kpi` string
            - `operator` string
            - `value` integer
          - `productCondition` object
            - `criteriaList` object[]
              - …
            - `kpi` string
            - `value` integer
            - `operator` string
          - `comboProductCondition` object
            - `productConditions` object[]
              - …
          - `tenderCondition` object
            - `type` string
            - `identifier` string
            - `tenderModes` object[]
              - …
            - `condition` string
        - `value` integer
        - `includeItemsFromConditionSet` boolean
      - `freeProductAction` object
        - `productBasedCondition` object
          - `type` string
          - `cartCondition` object
            - `kpi` string
            - `operator` string
            - `value` integer
          - `productCondition` object
            - `criteriaList` object[]
              - …
            - `kpi` string
            - `value` integer
            - `operator` string
          - `comboProductCondition` object
            - `productConditions` object[]
              - …
          - `tenderCondition` object
            - `type` string
            - `identifier` string
            - `tenderModes` object[]
              - …
            - `condition` string
        - `includeItemsFromConditionSet` boolean
      - `tenderBasedAction` object
        - `type` string
        - `value` integer
      - `perUnitAction` object
        - `rewardAction` string
        - `perUnitKPI` string
        - `perUnitDivider` integer
        - `includeItemsFromConditionSet` boolean
    - `createdBy` integer
    - `createdOn` string
    - `lastUpdatedBy` integer
    - `lastUpdatedOn` string
    - `startDate` integer
    - `endDate` integer
    - `campaignId` integer
    - `loyaltyEarningExpiryDays` integer
    - `maxEarningPerCustomer` integer
    - `earningCriteria` object
      - `criteriaName` string
      - `earnedFromType` string
      - `milestoneId` integer
      - `groupId` integer
      - `eventType` string
      - `storeCriteria` object
        - `type` string
        - `values` integer[]
        - `operator` string
      - `timeCriteria` object
        - `startTime` object
          - `hour` integer
          - `minute` integer
          - `second` integer
          - `nano` integer
        - `durationInHours` integer
        - `repeatFrequency` string
        - `weeklyValues` string[]
        - `monthlyDayValues` integer[]
      - `earningValidTillDays` integer
      - `criteriaDsl` string
      - `criteriaDslJson` string
      - `active` boolean
    - `promotionRestrictions` object
      - `additionalProp1` object[]
        - `kpi` string
        - `frequency` string
        - `minTimeBetweenRepeat` integer
        - `limit` integer
      - `additionalProp2` object[]
        - `kpi` string
        - `frequency` string
        - `minTimeBetweenRepeat` integer
        - `limit` integer
      - `additionalProp3` object[]
        - `kpi` string
        - `frequency` string
        - `minTimeBetweenRepeat` integer
        - `limit` integer
    - `earnLimitedToSpecificAudience` boolean
    - `customFieldValues` object
      - `additionalProp1` string
      - `additionalProp2` string
      - `additionalProp3` string
    - `onEarnCommunicationChannels` object
      - `additionalProp1` object
        - `subject` string
        - `message` string
        - `senderLabel` string
        - `senderReplyToEmail` string
        - `unsubscribeLabel` string
        - `senderEmail` string
        - `senderGSM` string
        - `senderCDMA` string
        - `domainPropertyId` string
        - `accountId` string
        - `channelType` string
        - `pushNotificationCta` object
          - `type` string
          - `actionLink` string
          - `image` string
          - `pushNotificationCtaActionList` object[]
            - `type` string
            - `actionLink` string
            - `actionText` string
            - `templateCtaId` string
      - `additionalProp2` object
        - `subject` string
        - `message` string
        - `senderLabel` string
        - `senderReplyToEmail` string
        - `unsubscribeLabel` string
        - `senderEmail` string
        - `senderGSM` string
        - `senderCDMA` string
        - `domainPropertyId` string
        - `accountId` string
        - `channelType` string
        - `pushNotificationCta` object
          - `type` string
          - `actionLink` string
          - `image` string
          - `pushNotificationCtaActionList` object[]
            - `type` string
            - `actionLink` string
            - `actionText` string
            - `templateCtaId` string
      - `additionalProp3` object
        - `subject` string
        - `message` string
        - `senderLabel` string
        - `senderReplyToEmail` string
        - `unsubscribeLabel` string
        - `senderEmail` string
        - `senderGSM` string
        - `senderCDMA` string
        - `domainPropertyId` string
        - `accountId` string
        - `channelType` string
        - `pushNotificationCta` object
          - `type` string
          - `actionLink` string
          - `image` string
          - `pushNotificationCtaActionList` object[]
            - `type` string
            - `actionLink` string
            - `actionText` string
            - `templateCtaId` string
    - `languagesConfigured` string[]
    - `customerActivationRequired` boolean
    - `isLoyaltyOnly` boolean
    - `mode` string
    - `maxIssuancePerCustomer` integer
    - `isStackable` boolean
    - `expiryDateChangeJobList` object[]
      - `jobType` string
      - `status` string
      - `createdOn` string
      - `lastUpdatedOn` string
      - `lastUpdatedBy` integer
      - `createdBy` integer
      - `impactedCount` integer
      - `message` string
    - `redeemableFromCriteria` object
      - `redeemableFrom` object
        - `period` integer
        - `type` string
      - `redemptionValidBeforeExpiry` object
        - `period` integer
        - `type` string
  - `errors` object[]
    - `code` integer
    - `message` string

## Other responses

- `400` — 400

---

[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)