Coupons
List coupons
selectkey<token>
API key para requisições autenticadas. Envie sua chave no cabeçalho selectkey (sandbox sk_test_…, produção sk_live_…).
In: header
Query Parameters
limit?integer
offset?integer
sort?string
Sort expression, e.g. "-createdAt"
daterange?|
daterangegt?string
daterangegte?string
daterangelt?string
daterangelte?string
id?string
Public identifier (dis_/coup_…)
name?string
code?string
type?string
status?string
dir?string
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/coupons"{
"offset": 0,
"limit": 0,
"total": 5000,
"page": {
"offset": {
"first": 0,
"prev": 0,
"next": 0,
"last": 0
},
"current": 0,
"total": 5000
},
"data": [
{
"id": "dis_0a1b2c3d4e5f60718293",
"name": "Acme Ltda",
"code": "string",
"type": "flat",
"value": 5000,
"enabled": true,
"minCartAmount": 5000,
"maxCartAmount": 5000,
"minCartItems": 0,
"maxCartItems": 0,
"usageLimit": 0,
"usageQuantity": 0,
"limitOneUsePerCustomer": true,
"isCumulative": true,
"initDate": "string",
"endDate": "string",
"allowedItemIds": [],
"allowedCustomerIds": [],
"scope": "firstCharge",
"recurringCycles": 0,
"createdAt": "string",
"updatedAt": "string"
}
],
"hasMore": true
}{
"error": {
"status": "Unauthorized",
"statusCode": 401,
"category": "authentication",
"code": "unauthorized",
"message": "Authentication is required to access this resource.",
"resource": "server"
}
}{
"error": {
"status": "Forbidden",
"statusCode": 403,
"category": "authorization",
"code": "forbidden",
"message": "You do not have permission to perform this action.",
"resource": "server"
}
}{
"error": {
"status": "Internal Server Error",
"statusCode": 500,
"category": "server",
"code": "serverError",
"message": "An unexpected error occurred. Please try again later.",
"resource": "server",
"details": "If the problem persists, contact support with the correlationId from the response headers."
}
}