List coupons
Retrieve a paginated list of coupons with optional filtering and searching.
Authorization
applicationPassword AuthorizationBasic <token>
WordPress Application Password authentication. Generate one at wp-admin > Users > Application Passwords. Use as Basic Auth with username:application_password (base64-encoded).
In: header
Query Parameters
page?integer
Page number
Default
1per_page?integer
Number of results per page
Default
10search?string
Search coupons by code or name
Response Body
application/json
application/json
curl -X GET "https://your-site.com/wp-json/fluent-cart/v2/coupons"{
"coupons": {
"current_page": 0,
"data": [
{
"id": 0,
"code": "string",
"title": "string",
"type": "percentage",
"amount": 0,
"status": "active",
"stackable": "yes",
"show_on_checkout": "yes",
"notes": "string",
"usage_count": 0,
"start_date": "2019-08-24T14:15:22Z",
"end_date": "2019-08-24T14:15:22Z",
"conditions": {
"max_uses": 0,
"min_purchase_amount": 0,
"max_discount_amount": 0,
"included_products": [
0
],
"included_categories": [
0
]
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"first_page_url": "string",
"from": 0,
"last_page": 0,
"last_page_url": "string",
"links": [
{
"url": "string",
"label": "string",
"active": true
}
],
"next_page_url": "string",
"path": "string",
"per_page": 0,
"prev_page_url": "string",
"to": 0,
"total": 0
}
}{
"code": "rest_forbidden",
"message": "Sorry, you are not allowed to do that.",
"data": {
"status": 401
}
}