> For the complete documentation index, see [llms.txt](https://docs.tebex.io/developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tebex.io/developers/headless-api/guides/coupons/apply-coupon.md).

# Apply Coupon

You can define Coupons in your store as discount codes for users to enter at checkout.

{% hint style="info" %}
Multiple coupons can be applied if enabled by the store. The `/remove` endpoints require specifying which coupon to remove.
{% endhint %}

## Apply a coupon

> Applies a coupon to a basket.

```json
{"openapi":"3.1.0","info":{"title":"Tebex Headless API","version":"2.0.0"},"tags":[{"name":"Headless","description":"Main API scoped to public token"}],"servers":[{"url":"https://headless.tebex.io/api/accounts/{token}","description":"Main API scoped to public token","variables":{"token":{"default":"","description":"The store's public token"}}}],"paths":{"/baskets/{basketIdent}/coupons":{"post":{"tags":["Headless"],"operationId":"applyCoupon","summary":"Apply a coupon","parameters":[{"$ref":"#/components/parameters/basketIdent"}],"description":"Applies a coupon to a basket.","requestBody":{"description":"Provide a `coupon_code` to apply to the basket.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyCouponRequest"}}}},"responses":{"200":{"description":"Successful response returns a success message.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}}}}}}}}}},"components":{"parameters":{"basketIdent":{"name":"basketIdent","in":"path","required":true,"schema":{"type":"string"},"description":"The basket identifier."}},"schemas":{"ApplyCouponRequest":{"type":"object","properties":{"coupon_code":{"type":"string"}}}}}}
```