---
title: "Returns a list of coupons"
method: GET
path: "/v2/backoffice/coupons"
tags: ["Coupons API"]
---

# Returns a list of coupons

`GET /v2/backoffice/coupons`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/backoffice/coupons`
- Auth: none declared

## Response `200`

OK

- JsonOkListResponseCouponDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` CouponDto[]
    - `id` integer
    - `owner` string
    - `ownerId` integer
    - `code` string
    - `createdAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `amount` number
    - `percentage` boolean
    - `billingCycles` integer
    - `hashTagBalance` integer
    - `expiresAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `maxDiscounts` integer
    - `discountCount` integer
    - `newUsers` boolean
    - `onlyAnnualPlans` boolean
    - `trial` integer
    - `revenue` number
    - `enabled` boolean
    - `assignedTeamCouponTracking` string
    - `label` string

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)