Coupon Codes (Bulk)

Get Coupon Codes

GET https://api.bigcommerce.com/stores/{store_hash}/v3/promotions/{promotion_id}/codes

Get codes for a particular promotion.

Note: The default rate limit for this endpoint is 40 concurrent requests.

store_hash in path - string
Accept in header with default of application/json - string
required
The MIME type of the response body.
promotion_id in path - string
required
The ID of the associated promotion.
before in query - string
A cursor that can be used for backwards pagination. Will fetch results before the position corresponding to the cursor. Cannot be used with the 'page' query parameter. Cannot be used with the 'after' query parameter.
after in query - string
A cursor that can be used for forwards pagination. Will fetch results after the position corresponding to the cursor. Cannot be used with the 'page' query parameter. Cannot be used with the 'before' query parameter.
page in query - integer
Query parameter that specifies the page number in a paginated list of resources. This field is deprecated and the 'before' and 'after' cursor parameters should be used instead.
limit in query - integer
Query parameter that limits the number of items displayed per page in a paginated list of resources. When none is specified a default value of 50 is used.

object | application/json

dataarray[object]
metaobject
Contains data about paginating the response via cursors. If no pagination details are specified, then both properties will be present. When a 'before' or 'after' cursor is provided, only the 'cursor_pagination' property will be present. When a 'page' parameter is provided, only the offset based 'pagination' property will be present.

DELETE https://api.bigcommerce.com/stores/{store_hash}/v3/promotions/{promotion_id}/codes

Deletes multiple coupon codes relating to the given promotion. Currently, batches are limited to 50 coupon codes.

Notes

"id:in" query param is required to delete coupon codes. If not provided, or provided with the wrong data format, a 422 error code is returned.
The default rate limit for this endpoint is 40 concurrent requests.

store_hash in path - string
Accept in header with default of application/json - string
required
The MIME type of the response body.
id:in in query - array
required
A comma-separated list of promotions to filter or target with this operation.
Example: ?id:in=11,12,13,14
Type: array[integer]
promotion_id in path - string
required
The ID of the associated promotion.

A 204 response.

Did you find what you were looking for?