Cupons - Ler
GET /v1/coupons/{couponId}
Obtém os detalhes completos de um cupom.
Requisição
Shell
curl "https://api.selectwin.io/v1/coupons/dis_01hqzvabc" \
-H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ"Resposta - 200 OK
JSON
{
"id": "dis_01hqzvabc",
"name": "Black Friday 25%",
"code": "BLACKFRIDAY25",
"type": "percentage",
"value": 25,
"enabled": true,
"minCartAmount": 10000,
"maxCartAmount": null,
"minCartItems": null,
"maxCartItems": null,
"usageLimit": 100,
"usageQuantity": 0,
"redemptionsCount": 0,
"limitOneUsePerCustomer": true,
"isCumulative": false,
"initDate": "2026-04-01T00:00:00.000Z",
"endDate": "2026-04-30T23:59:59.000Z",
"allowedItemIds": null,
"allowedCustomerIds": null,
"scope": "firstCharge",
"recurringCycles": null,
"createdAt": "2026-04-12T17:56:33.000Z",
"updatedAt": "2026-04-12T17:56:33.000Z"
}Nota: Root level, objeto completo, sem merchant nem _links.
Atributos da Resposta
Mesmos do Create (ver Create.md).
Respostas de Erro
error.code | HTTP | Quando |
|---|---|---|
couponNotFound | 404 | Nenhum cupom com o couponId informado. |
Melhores Práticas
- Use
redemptionsCount(contrausageLimit) para saber quanto do cupom ainda resta antes de promovê-lo.
Atualizado em 21 de outubro de 2026