---
search:
  tags:
    - Coupons
    - GET
seo:
  description: >-
    Admin only. Returns every coupon ordered by code, with numeric discount and
    an active… Reference for the GET /api/v1/coupons endpoint in the PharmaFlow
    API.
sidebar:
  label: List coupons
  badge: GET
title: List coupons
type: openapi-operation
---
Admin only. Returns every coupon ordered by code, with numeric discount and an active flag. The whole registry is returned, not a page, so the console can hold coupon admin offline.

`GET /api/v1/coupons`

**Responses**

- `200` — Every coupon
- `401` — Not authenticated
- `403` — Caller is not an admin

Response example, 200:

```json
[
  {
    "id": "string",
    "code": "string",
    "type": "string",
    "discount_type": "string",
    "discount_value": 0,
    "description": "string",
    "valid_from": "string",
    "valid_until": "string",
    "max_uses": -9007199254740991,
    "usage_count": -9007199254740991,
    "is_active": true
  }
]
```