> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinmarkt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant coupons

> Create and manage store coupons with a Bearer API key.

All routes require:

```txt theme={null}
Authorization: Bearer mk_live_<your_key>
```

Paths are store-scoped. Dashboard ceiling: `manageCoupons`. `storeId` in the JSON body is ignored.

## List / create

```http theme={null}
GET  /api/merchant/v1/stores/{storeId}/coupons?page=1&limit=50
POST /api/merchant/v1/stores/{storeId}/coupons
```

Scopes: `coupon:read` · `coupon:create` · `201`

```json theme={null}
{
  "code": "SAVE10",
  "discountType": "percentage",
  "discountValue": 10,
  "minPurchase": 0,
  "usageLimit": 100,
  "isActive": true
}
```

`discountType` is `percentage` or `fixed`. Duplicate codes return `400`.

## Get / update / delete

```http theme={null}
GET    /api/merchant/v1/stores/{storeId}/coupons/{couponId}
PATCH  /api/merchant/v1/stores/{storeId}/coupons/{couponId}
DELETE /api/merchant/v1/stores/{storeId}/coupons/{couponId}
```

Scopes: `coupon:read` · `coupon:update` · `coupon:delete`

A coupon from another shop returns `404`.

## Related

* [API keys](/developers/api-keys)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.