Retrieve list of coupons

GET {{baseUrl}}/v1/coupons?starting_after=<string>&ending_before=<string>&limit=100

Retrieve a list of all coupons

Request Params

KeyDatatypeRequiredDescription
starting_afterstringThe ID of the coupon created before the first coupon you want to retrieve
ending_beforestringThe ID of the coupon created after the last coupon you want to retrieve
limitnumberThe maximum number of coupons to return. Range is 1-100. Default is 10

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;amount_off&quot;:&quot;\u003cnumber\u003e&quot;,&quot;created&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;BTN&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;discount_duration_in_uses&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount_valid_until&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount_validity_in_months&quot;:&quot;\u003cnumber\u003e&quot;,&quot;duration&quot;:&quot;forever&quot;,&quot;duration_in_months&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;max_redemptions&quot;:&quot;\u003cnumber\u003e&quot;,&quot;metadata&quot;:{},&quot;percent_off&quot;:100,&quot;redeem_by&quot;:&quot;\u003cnumber\u003e&quot;,&quot;times_redeemed&quot;:&quot;\u003cnumber\u003e&quot;,&quot;valid&quot;:&quot;\u003cboolean\u003e&quot;},{&quot;amount_off&quot;:&quot;\u003cnumber\u003e&quot;,&quot;created&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;MDL&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;discount_duration_in_uses&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount_valid_until&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount_validity_in_months&quot;:&quot;\u003cnumber\u003e&quot;,&quot;duration&quot;:&quot;forever&quot;,&quot;duration_in_months&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;max_redemptions&quot;:&quot;\u003cnumber\u003e&quot;,&quot;metadata&quot;:{},&quot;percent_off&quot;:5,&quot;redeem_by&quot;:&quot;\u003cnumber\u003e&quot;,&quot;times_redeemed&quot;:&quot;\u003cnumber\u003e&quot;,&quot;valid&quot;:&quot;\u003cboolean\u003e&quot;}],&quot;status&quot;:{&quot;error_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;operation_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;response_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;}}