Skip to main content
GET
/
discounts
/
promotions
/
promo-code
/
{promoCode}
{
  "promotionId": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "promoCode": "SUMMER25",
  "discountPeriodMonths": 12,
  "validFrom": "2023-12-25",
  "validTo": "2023-12-25",
  "discountId": "<string>",
  "discount": {
    "discountId": "80df6fdf-c450-406e-948b-f77d4ac1cdb8",
    "description": "25% Off Summer Promo",
    "tag": "SUMMER25",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

An API key that grants access to the Connect API. You can create and manage API keys in the portal.

Path Parameters

​
promoCode
string
required

The promotional code to look up.

Response

Promotion details including associated discount information.

A promotion that applies a discount when the promotional code is used.

​
promotionId
string
required

The unique identifier for the promotion.

Example:

"497f6eca-6276-4993-bfeb-53cbbbba6f08"

​
discountPeriodMonths
integer
required

The number of months the discount will be applied.

Example:

12

​
discountId
string
required

The unique identifier for the discount.

​
discount
object
required

Essential discount information without sensitive details.

​
promoCode
string

The promotional code that customers can use to activate this promotion.

Example:

"SUMMER25"

​
validFrom
string<date>

When the promotion becomes valid and can be used.

If not provided, the promotion is valid immediately.

​
validTo
string<date>

When the promotion expires and can no longer be used.

If not provided, the promotion does not expire.

⌘I