CartrouteFind coupons: GET /api/v1/coupons
GET /api/v1/coupons lists active retailer promotions, filterable by retailer, category or product, each with its redemption success rate, sample size, terms and expiry. Costs 0 credit. Coupons that apply to a product are also embedded in every search and product offer.
Coupon verification is not connected for Amazon, Best Buy and eBay yet, so this endpoint currently returns an empty list and costs nothing. The retailer's own discount from its list price is in every offer as list_price_usd and discount_from_list_pct.
Which filters does it take?
| Name | Type | Description |
|---|---|---|
retailer | string | Retailer id or slug. |
category | string | Category name. Returns category coupons and sitewide ones. |
product | string | Product id, slug, GTIN or MPN. Returns coupons that apply to it. |
limit | integer 1–100 | Default 50. Sorted by success rate, then sample size. |
What does a coupon look like?
{
"coupon_id": "cpn_05pgl3b",
"retailer_id": "amazon",
"retailer_name": "Amazon",
"code": null,
"requires_code": false,
"kind": "percent",
"value": 20,
"value_unit": "percent",
"title": "20% off one kitchen item",
"terms": "Must be clipped on the product page before checkout.",
"min_spend_usd": null,
"applies_to": "category:Kitchen",
"stacks_with_sale": true,
"requires_eligibility": false,
"success_rate": 0.68,
"sample_size": 3301,
"last_verified_at": "2026-09-23T07:12:40.000Z",
"expires_at": "2026-09-30T10:12:40.000Z",
"source": "loyalty_program"
}
What do the coupon fields mean?
| Field | Meaning |
|---|---|
code, requires_code | The code to enter, or null when the promotion applies automatically. |
kind | percent, amount (USD off), shipping (free shipping) or gift_card (a perk; never subtracted from price). |
applies_to | product, category:<name> or sitewide. |
min_spend_usd | Minimum order value, or null. |
requires_eligibility | Student, education or similar. Listed, never assumed in effective_price_usd. |
success_rate, sample_size | Share of recent redemption attempts that applied, and how many attempts that is based on. |
stacks_with_sale | Whether it applies on top of a sale price. |
last_verified_at, expires_at | When it was last checked, and when it ends. Expired coupons never appear. |
estimated_savings_usd | Only inside an offer: the saving on that specific offer. |
How much should an agent trust a coupon?
Weigh success_rate by sample_size: 0.9 over 2,000 attempts is dependable, 0.9 over 40 is a hint. Automatic promotions (requires_code: false) are the most reliable because the retailer applies them only when the cart qualifies. Tell the shopper about terms that need action, such as activating a loyalty offer.