Coupons
List all coupons
API Reference
- Getting started
- Add-ons
- Analytics
- Billable metrics
- Coupons
- Credit notes
- Customer usage
- Customers
- Events
- Fees
- Invoices
- Organizations
- Payments
- Payment receipts
- Payment requests
- Plans
- Resources
- Subscriptions
- Taxes
- Wallets
- Webhook endpoints
- Webhooks
Coupons
List all coupons
This endpoint is used to list all existing coupons.
GET
/
coupons
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request GET "$LAGO_URL/api/v1/coupons?per_page=2&page=1" \
--header "Authorization: Bearer $API_KEY"
{
"coupons": [
{
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"name": "Startup Deal",
"code": "startup_deal",
"description": "I am a coupon description",
"coupon_type": "fixed_amount",
"amount_cents": 5000,
"amount_currency": "USD",
"reusable": true,
"limited_plans": true,
"plan_codes": [
"startup_plan"
],
"limited_billable_metrics": false,
"billable_metric_codes": [],
"percentage_rate": null,
"frequency": "recurring",
"frequency_duration": 6,
"expiration": "time_limit",
"expiration_at": "2022-08-08T23:59:59Z",
"created_at": "2022-04-29T08:59:51Z",
"terminated_at": "2022-08-08T23:59:59Z"
}
],
"meta": {
"current_page": 2,
"next_page": 3,
"prev_page": 1,
"total_pages": 4,
"total_count": 70
}
}
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request GET "$LAGO_URL/api/v1/coupons?per_page=2&page=1" \
--header "Authorization: Bearer $API_KEY"
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Page number.
Example:
1
Number of records per page.
Example:
20
Response
200
application/json
Coupons
The response is of type object
.
Was this page helpful?
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request GET "$LAGO_URL/api/v1/coupons?per_page=2&page=1" \
--header "Authorization: Bearer $API_KEY"
{
"coupons": [
{
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"name": "Startup Deal",
"code": "startup_deal",
"description": "I am a coupon description",
"coupon_type": "fixed_amount",
"amount_cents": 5000,
"amount_currency": "USD",
"reusable": true,
"limited_plans": true,
"plan_codes": [
"startup_plan"
],
"limited_billable_metrics": false,
"billable_metric_codes": [],
"percentage_rate": null,
"frequency": "recurring",
"frequency_duration": 6,
"expiration": "time_limit",
"expiration_at": "2022-08-08T23:59:59Z",
"created_at": "2022-04-29T08:59:51Z",
"terminated_at": "2022-08-08T23:59:59Z"
}
],
"meta": {
"current_page": 2,
"next_page": 3,
"prev_page": 1,
"total_pages": 4,
"total_count": 70
}
}