---
title: "Redeem a promotion code against a charge or invoice"
method: POST
path: "/v1/promotion-codes/redeem"
tags: ["Coupons"]
---

# Redeem a promotion code against a charge or invoice

`POST /v1/promotion-codes/redeem`

Apply a promotion code to a gross amount. Returns the discount amount, the
new net amount, and the redemption record. Increments the redeem counters
on both the coupon and the promotion code atomically.

Validates: code exists, coupon active, within validity window, not at
redemption cap (global, per-code, per-customer), and (if restricted)
matches the redeeming customer.

## Response `200`

Default Response

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)