Skip to content

List WooCommerce coupons

Module · Stable

Every coupon in the shop, newest first — what’s live, expired or spent.

Reads the connected shop’s coupons, newest first, and returns them with the same derived facts Check WooCommerce coupon gives per code — expired, exhausted, email_restricted, usable — so a table or a scheduled sweep can show at a glance what’s still live. This is the plural counterpart to Check WooCommerce coupon — reach for that one when the question is about a single code and this one when it’s about the whole set. Unlike List WooCommerce orders it does page through the shop to meet the requested limit, because the question this serves is a full sweep rather than a recent-N glance; has_more tells you the limit was hit before the shop ran out. Read-only.

Landing the coupon list on a table on a schedule so support can see what’s live, what expired overnight and what just ran out, without opening the WooCommerce admin. Also a sanity check before a marketing push — confirming the campaign code is actually live and not already exhausted from an earlier run.

Not when a customer has already given you a specific code — Check WooCommerce coupon is the direct lookup and returns the email-restricted case correctly; re-deriving that from a full list invites a mismatch if the list run is stale. Not for creating, editing or disabling a coupon: this package has no write path at all, by design.

Configured per use: limit.

  • found
  • count
  • coupons
  • has_more
  • error

the woocommerce integration


Auto-generated from the skill registry (load_skills()). Do not edit by hand.