Skip to main content
GET
/
coupons
curl -X GET https://api.example.com/coupons \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN"

[
  {
    "id": 1,
    "name": "SUMMER2026",
    "percentage": 25,
    "expirationDate": "2026-08-31"
  },
  {
    "id": 2,
    "name": "NEWYEAR2026",
    "percentage": 15,
    "expirationDate": "2026-01-15"
  },
  {
    "id": 3,
    "name": "BLACKFRIDAY",
    "percentage": 50,
    "expirationDate": "2026-11-30"
  }
]
This endpoint requires admin authentication. Include a valid admin JWT token in the Authorization header.

​
Response

Returns an array of all coupon objects in the system.
​
coupons
array
Array of coupon objects
curl -X GET https://api.example.com/coupons \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN"

[
  {
    "id": 1,
    "name": "SUMMER2026",
    "percentage": 25,
    "expirationDate": "2026-08-31"
  },
  {
    "id": 2,
    "name": "NEWYEAR2026",
    "percentage": 15,
    "expirationDate": "2026-01-15"
  },
  {
    "id": 3,
    "name": "BLACKFRIDAY",
    "percentage": 50,
    "expirationDate": "2026-11-30"
  }
]

​
Use Cases

  • View all available coupons for admin management
  • Check expiration dates of existing coupons
  • Audit discount percentages across all coupons
  • List coupons for administrative dashboards

Build docs developers (and LLMs) love

Get started for freeTalk to us