API documentation
User
Tenant
Feature
Entitlement
User & permissions
Settings
- Settings
- Media
- Webhook
- Notification
Payment
- Payment Method
- Transaction
- SEPA XML
- Open Banking
- Bank Account Transaction
Customer
- Customer
- Customer Address
- Customer Email
- Customer Settings
- Customer Otp
Billing
- Invoice
- Invoice Position Item
- Billing Run
Dunning
- Dunning Document
- Dunning Rule
Subscription
- Subscription
- Subscription Item
- Subscription Measurement
- Billing Group
Offers
- Offer
- Offer Recipient
- Offer Template
Catalogue
- Unit
- Measurement
- Product
- Product Family
- Price Plan
- Coupon
Checkout
- Checkout Link
- Cart
Accounting
Get all coupons
Get all coupons.
Required permissions:coupon:readcurl -X GET \
/coupons \
--header "Authorization: Bearer <token>"{
"data": [
{
"id": "<string>",
"code": "10OFF",
"name": "10% off",
"type": "<any>",
"percentage": 10,
"fixedAmount": {},
"frequency": "<any>",
"frequencyInterval": 3,
"maxRedemptions": "null",
"expiresAt": "null",
"isEnabled": true,
"createdAt": "2021-01-01T00:00:00+00:00",
"updatedAt": "2021-01-01T00:00:00+00:00",
"reedemptions": true
}
],
"meta": {
"pagination": {
"totalItems": 123,
"itemsPerPage": 123,
"currentPage": 123,
"lastPage": 123,
"pageTotalItems": 123
}
}
}Authorizations
Value for the Authorization header parameter.
Query Parameters
The collection page number
The number of items per page
0 < x < 100Response
The code that can be used to apply this coupon or to use it with the api.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The id of this coupon.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The number of times this coupon can be redeemed in total. If null, there is no limit.
The date and time this coupon will expire. If null, there is no expiration date.
Whether this coupon is enabled or not.
The date and time when the resource was created.
The date and time when the resource was last updated.
Has this coupon been redeemed by a customer? If yes, it cannot be edited or deleted anymore.
Was this page helpful?
curl -X GET \
/coupons \
--header "Authorization: Bearer <token>"{
"data": [
{
"id": "<string>",
"code": "10OFF",
"name": "10% off",
"type": "<any>",
"percentage": 10,
"fixedAmount": {},
"frequency": "<any>",
"frequencyInterval": 3,
"maxRedemptions": "null",
"expiresAt": "null",
"isEnabled": true,
"createdAt": "2021-01-01T00:00:00+00:00",
"updatedAt": "2021-01-01T00:00:00+00:00",
"reedemptions": true
}
],
"meta": {
"pagination": {
"totalItems": 123,
"itemsPerPage": 123,
"currentPage": 123,
"lastPage": 123,
"pageTotalItems": 123
}
}
}