---
title: "Redeem bulk coupons"
method: POST
path: "/coupon/bulk/redeem"
---

# Redeem bulk coupons

`POST /coupon/bulk/redeem`

Lets you redeem one or more coupons of a customer.

## Request body

- object
  - `redemptionRequestList` unknown[], required — List of coupons to redeem.
    - unknown
  - `code` string — Coupon code to redeem.
  - `redemptionTime` string, date — Date and time of redemption in YYYY-MM-DD HH:MM:SS format. The time defined here is used for certain evaluations, but it is not stored in the system. The system considers the store's current time as the redemption time.
  - `transactionNumber` string — Transaction number for which the coupon(s) needs to be redeemed.
  - `billAmount` number, double, required — Transaction amount for which the coupon is redeemed.
  - `user` object — Details of the customer that redeems the coupon(s).
    - `id**` integer — Unique ID of the customer.
    - `mobile**` string — Mobile number of the customer.
    - `email**` string — Email ID of the customer.
    - `externalId**` string — External ID of the customer.
    - `cardnumber` string — Card number of the customer.
    - `cardExternalId` string — Card external ID of the customer.

## Response `200`

200

- object
  - `response` object[]
    - `entityId` integer
    - `result` object
      - `id` integer
      - `currencyInput` boolean
      - `localToBaseCurrencyExchangeRate` integer
      - `warnings` unknown[]
        - unknown
      - `appendedErrorMessage` string
      - `code` string
      - `discountCode` string
      - `seriesCode` integer
      - `isAbsolute` boolean
      - `couponValue` integer
      - `redemptionStatus` object
        - `statusCode` object
          - `status` boolean
          - `message` string
          - `code` integer
        - `warnings` unknown[]
          - unknown
        - `warningsAsStatusCode` unknown[]
          - unknown
        - `message` string
        - `code` integer
        - `success` boolean
      - `discountType` string
      - `discountValue` integer
      - `discountUpto` integer
    - `errors` unknown[]
      - unknown
  - `totalCount` integer
  - `failureCount` integer

## 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/versions/de241f2ed9b3/schema)