List Coupon Codes | BigCommerce Developer Center

Get codes for a particular promotion.

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

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Marketing	modify	`store_v2_marketing`
Marketing	read-only	`store_v2_marketing_read_only`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see API Accounts and OAuth Scopes.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Marketing | modify | `store_v2_marketing` | | Marketing | read-only | `store_v2_marketing_read_only` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts). For more about BigCommerce OAuth scopes, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Path parameters

promotion_idstringRequired

The ID of the associated promotion.

Query parameters

beforestringOptional

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.

afterstringOptional

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.

pageintegerOptional>=1Deprecated

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.

limitintegerOptional1-250

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.

codestringOptional

Filter items by code.

Response

datalist of objects

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.

1	{
2	"data": [
3	{
4	"id": 1,
5	"code": "TEST_COUPON",
6	"current_uses": 0,
7	"created": "2019-01-20T22:00:00+00:00",
8	"max_uses": 10,
9	"max_uses_per_customer": 5
10	}
11	],
12	"meta": {
13	"pagination": {
14	"total": 1,
15	"count": 1,
16	"per_page": 50,
17	"current_page": 1,
18	"total_pages": 1,
19	"links": {
20	"current": "?page=1&limit=50"
21	}
22	},
23	"cursor_pagination": {
24	"count": 1,
25	"per_page": 50,
26	"links": {
27	"next": "?limit=5&after=eyJpZCI6IjIzNzU1NyJ9"
28	},
29	"start_cursor": "eyJpZCI6IjIzNzU1NyJ9",
30	"end_cursor": "eyJpZCI6IjIzNzU1MyJ9"
31	}
32	}
33	}

1	curl -G https://api.bigcommerce.com/stores/store_hash/v3/promotions/promotion_id/codes \
2	-H "X-Auth-Token: <apiKey>" \
3	-d code=TEST_COUPON