GET
/
redemptions

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-fabric-tenant-id
string
required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

Required string length: 24
x-fabric-channel-id
string

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

x-client-id
string

A unique identifier obtained from Copilot for the System app in the fabric ecosystem, essential for OpenID Connect authentication flows.

x-fabric-request-id
string

A unique request ID.

Query Parameters

size
integer
default: 10

The maximum number of records per page.

Required range: 1 < x < 100
startCursor
string

Specifies the record from which the search will start, effectively skipping all records before this point.

Maximum length: 1000
promotionId
string

Promotion ID for which you want to get the redemption records

couponCode
string

Coupon code for which you want to get the redemption records

userId
string

ID of the user for whom you want to get the redemption records

email
string

Email address of the user for whom you want to get the redemption records

orderId
string

Order ID associated with the redemption records

storeId
string

Comma-separated IDs of the stores for which you want to get the redemption records

status
enum<string>

Status by which you want to filter the redemption records. The options are:<br>ACTIVE: Refers to the created redemption records.<br>INACTIVE: Refers to the redemption records that are generated but are inactive due to order cancellations.

Available options:
ACTIVE,
INACTIVE
redeemedFrom
string

If specified, it returns the redemption records that are created from this specific date

redeemedTo
string

If specified, it returns the created redemption records till this specific date

updatedFrom
string

If specified, it returns the redemption records that are updated from this specific date

updatedTo
string

If specified, it returns the updated redemption records till this specific date

additionalAttributes
string

Additional attributes to filter redemption records

promotionAdditionalAttributes
string

Promotion-specific additional attributes to filter redemption records

promotionName
string

Promotion name by which you want to filter the redemption records

isImplicit
boolean

This boolean query parameter is used to filter for redemptions associated with either implicit or non-implicit promotions. If the filter isn't provided, the response will include all redemptions.

singleMultiUse
enum<string>

Filter that indicates if the redemptions will belong to SINGLE or MULTI use coupon. If not sent, all redemptions will be returned.

Available options:
SINGLE_USE,
MULTI_USE

Response

200 - application/json

Redemption information

query
object

The pagination details.

data
object[]

Redemptions list