---
title: "Report Customer Redemptions"
method: POST
path: "/v1/promocodes/{promocodeId}/customerRedemptions"
tags: ["PromoCodeQuery"]
---

# Report Customer Redemptions

`POST /v1/promocodes/{promocodeId}/customerRedemptions`

Persist the individual customer redemptions per promocode

## Path parameters

- `promocodeId` string, required

## Request body

- QueryserviceCustomerRedemptions
  - `redemptions` ServiceCustomerRedemption[]
    - `customerId` string
    - `redemptionTimestamp` string, date-time
    - `uniqueCode` string
    - `transactionId` string
    - `metadata` object
    - `effect` CommoncontextEffect
      - `promotionTier` integer
      - `effectNotification` 'NO_EFFECT_NOTIFICATION' | 'CONSTRAINED_BY_PROMOTION_MAX_REWARD' | 'CONSTRAINED_BY_PROMOTION_MIN_REWARD' | 'CONSTRAINED_BY_TENANT_MAX_REWARD' | 'CONSTRAINED_BY_TENANT_MIN_REWARD' | 'REWARD_CALCULATION_FAILED' | 'PROMOTION_INACTIVE' | 'FAILED_CONDITIONS' | 'FAILED_TIERS' | 'CAP_LIMIT' | 'UNIT_COUNT_LIMIT' | 'AMOUNT_CENTS_LIMIT' | 'EFFECT_TYPE_NOT_SUPPORTED'
      - `unit` CommoncontextItemsUnitEffect
        - `unitCount` integer
        - `unitRewardTypeId` string
      - `amount` CommoncontextItemsAmountEffect
        - `amountCents` integer
        - `amountRewardTypeId` string

## Response `200`

A successful response.

- object

## Other responses

- `201` — Customer redemptions successfully persisted
- `default` — An unexpected error response.

---

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