Discount coupon state: ACTIVE, PAUSED, EXPIRED or USEDUP
discount
number
Discount amount
launchDate
string
The date of coupon launch, e.g. 2014-06-06 08:00:00 +0400. Any date provided will be corrected to the UTC timezone
expirationDate
string
Coupon expiration date, e.g. 2014-06-06 08:00:00 +0400. Any date provided will be corrected to the UTC timezone
totalLimit
number
The minimum order subtotal the coupon applies to
usesLimit
string
Number of uses limitation: UNLIMITED, ONCEPERCUSTOMER, SINGLE
repeatCustomerOnly
boolean
Deprecated. Use applicationLimit instead. Coupon usage limitation flag identifying whether the coupon works for all customers or only repeat customers
applicationLimit
string
Application limit for discount coupons. Possible values: "UNLIMITED", "NEW_CUSTOMER_ONLY", "REPEAT_CUSTOMER_ONLY". If you are creating or updating a discount coupon, make sure to use the old repeatCustomerOnly field or the new applicationLimit field only. When both these fields are sent, the priority will be given to the new field – applicationLimit
creationDate
string
Coupon creation date. Format example: 2016-06-29 11:36:55 +0000
updateDate
string
Coupon update date. Format example: 2016-06-29 11:36:55 +0000
orderCount
number
Number of uses
catalogLimit
<DiscountCouponCatalogLimit>
The products and categories the coupon can be applied to
shippingLimit
<DiscountCouponShippingLimit>
Shipping methods, the cost of which will be free after applying the coupon (for 'Free shipping' coupons).
DiscountCouponCatalogLimit
Field
Type
Description
products
Array
The list of product IDs the coupon can be applied to
categories
Array
The list of category IDs the coupon can be applied to
DiscountCouponShippingLimit
Field
Type
Description
shippingMethods
Array
The list of shipping method IDs, the cost of which will be free after applying the coupon
Errors
In case of error, Ecwid responds with an error HTTP status code and, optionally, JSON-formatted body containing error description
HTTP codes
HTTP Status
Meaning
400
Request parameters are malformed
403
Access token doesn't have read_discount_coupons scope
415
Unsupported content-type: expected application/json or text/json
500
Cannot retrieve the coupon info because of an error on the server
Error response body (optional)
Field
Type
Description
errorMessage
string
Error message
Language
Click Try It! to start a request and see the response here!