---
title: "Summarize coupon redemption failures in session"
method: GET
path: "/v1/coupon_rejections"
tags: ["Coupons"]
---

# Summarize coupon redemption failures in session

`GET /v1/coupon_rejections`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/coupon_rejections`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/coupon_rejections/get.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Create a summary of the reasons for coupon redemption failures in a given customer session.

## Query parameters

- `sessionIntegrationId` string, required
- `applicationId` number
- `language` string
- `couponCode` string

## Response `200`

OK

- object
  - `data` CouponFailureSummary[], required
    - `id` integer, required: ID of the evaluation record.
    - `eventID` integer, required: ID of the event.
    - `sessionID` string: ID of the customer session set by your integration layer.
    - `profileID` string: ID of the customer profile set by your integration layer.
    - `status` string, required: Status defines if the coupon code was applied or rejected.
    - `couponCode` string, required: Coupon code passed for evaluation.
    - `language` string, required: Language of the summary.
    - `summary` string, required: A summary of the reasons for coupon redemption failure.
    - `createdAt` string, date-time, required: Timestamp when the request was made.
    - `updatedAt` string, date-time, required: Timestamp when the request was last updated.

---

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