List coupons
Coupons with code, discount, usage count, limit and expiry date.
GET https://cotlet.dev/api/v1/woocommerce/coupons
read
Lists coupons with the code, discount type, amount, how many times each was used, its usage limit and its expiry date. Search by text or look up an exact code before you create one. Coupon codes are not case-sensitive in WooCommerce.
Parameters
| Name | Type | Description |
|---|---|---|
| code string | string | Exact coupon code. |
| search string | string | Text in the coupon code. |
| limit integer | integer | Results per page. Default: 10. |
| page integer | integer | Page number, starting at 1. Default: 1. |
Request
curl https://cotlet.dev/api/v1/woocommerce/coupons \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("woocommerce", "list_coupons")const result = await cotlet.call('woocommerce', 'list_coupons');cotlet call woocommerce list_couponsExample response
{
"coupons": [
{
"coupon_id": 2201,
"code": "welcome10",
"discount_type": "percent",
"amount": "10",
"usage_count": 41,
"usage_limit": 500,
"date_expires": "2026-12-31"
}
],
"total": 1,
"total_pages": 1
}