CartrouteFind coupons: GET /api/v1/coupons
GET /api/v1/coupons lists active coupon codes and automatic promotions, filterable by retailer, category or product, each with its redemption success rate, sample size, terms and expiry. Costs 1 credit. Coupons that apply to a product are also embedded in every search and product offer.
GET https://cart-route.com/api/v1/coupons?retailer=target
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": "target",
"retailer_name": "Target",
"code": "CIRCLE20KIT",
"requires_code": true,
"kind": "percent",
"value": 20,
"value_unit": "percent",
"title": "Target Circle 20% off one kitchen item",
"terms": "Requires a Target Circle account. Must be activated in the app 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.