---
title: "Apply coupon to customer"
method: POST
path: "/api/coupons/apply"
tags: ["Coupons"]
---

# Apply coupon to customer

`POST /api/coupons/apply`

Apply a coupon to a specific customer, optionally linked to a subscription.

## Request body

- ApplyCouponDto
  - `couponId` string, required
  - `customerId` string, required
  - `subscriptionId` string
  - `usesRemaining` number — Number of billing cycles to apply (null = forever)

## Response `201`

Coupon applied

- AppliedCouponResponse
  - `id` string, required
  - `couponId` string, required
  - `customerId` string, required
  - `subscriptionId` string
  - `amountOff` string
  - `usesRemaining` number
  - `createdAt` string, required

## Other responses

- `400` — Coupon expired, inactive, or already applied
- `404` — Coupon or customer not found

---

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