List Cart Rule Coupons

Lists every coupon code attached to one cart rule — the coupon table on the admin Marketing → Promotions → Cart Rules → Coupons screen.

TIP

New here? Read the Cart Rule Coupons overview for what a coupon does and how its fields behave.

Operation

Operation	Type	Purpose
adminMarketingCartRuleCoupons	Query	Cursor-paginated list of one cart rule's coupons

Details

• Requires an admin Bearer token in the Authorization header.
• This is a sub-resource of a cart rule — cartRuleId is required and scopes the list to that rule. Coupons from other rules never appear in the result.
• An unknown cartRuleId returns a 404 error.
• Cursor pagination — pass first for the page size and after (the endCursor from the previous page) to advance. totalCount is the grand total.

Arguments

Argument	Type	Required	Notes
cartRuleId	Int	Yes	Parent cart-rule id; scopes the list
first	Int	No	Page size
after	String	No	Cursor (endCursor from the previous page)