Skip to main content
GET
/
coupons
/
{id}
Get a coupon
curl --request GET \
  --url https://api.salesive.com/api/v1/coupons/{id} \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "success": true,
  "message": "Coupon retrieved",
  "data": {
    "_id": "66b1f2a9c4d5e6f7a8b9c0d1",
    "code": "SUMMER20",
    "user": "66a0e1b2c3d4e5f6a7b8c9d0",
    "shop": "66a0d1c2b3a4958677564738",
    "type": "percentage",
    "discount": 20,
    "usageLimit": 100,
    "usageCount": 12,
    "usagePerUser": 1,
    "minimumOrderAmount": 5000,
    "startDate": "2026-06-01T00:00:00.000Z",
    "endDate": "2026-08-31T23:59:59.000Z",
    "active": true,
    "createdAt": "2026-05-20T10:15:00.000Z",
    "updatedAt": "2026-06-25T09:00:00.000Z"
  }
}
Returns one coupon by id, scoped to the store bound to your app token; returns 404 if it does not exist in this store. The store is bound to your app token server-side — never send a shop id.

Authorizations

​
Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Path Parameters

​
id
string
required

The coupon's unique id.

Response

The requested coupon.

Standard Salesive response envelope. The operation-specific payload is carried in data.

​
status
integer
required

HTTP status code, echoed in the body.

​
success
boolean
required

Whether the request succeeded.

​
message
string
required

Human-readable result message.

​
data
object

A store-scoped discount coupon.