Skip to main content
Get all discount coupons
curl --request GET \
  --url https://api.salesbricks.com/api/v2/discount-coupons \
  --header 'X-SALESBRICKS-KEY: <api-key>'
{
  "count": 123,
  "results": [
    {
      "code": "<string>",
      "name": "<string>",
      "description": "<string>",
      "expires_at": "2023-11-07T05:31:56Z",
      "discount_type": "<string>",
      "discount_rate": "<string>",
      "duration_months": 123,
      "active": true,
      "is_expired": true
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

Authorizations

​
X-SALESBRICKS-KEY
string
header
required

API key for authentication

Query Parameters

​
active
boolean

Filter by active status (true/false)

​
limit
integer

Maximum number of coupons to return (default: 100, max: 1000)

​
offset
integer

Number of records to skip (default: 0)

​
ordering
enum<string>

Order results by field (prefix with '-' for descending order)

Available options:
-created_at,
created_at
​
valid
boolean

Filter to only valid coupons (active, not expired, under usage limit)

Response

200 - application/json
​
count
integer
required
Example:

123

​
results
object[]
required
​
next
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=400&limit=100"

​
previous
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=200&limit=100"