---
title: "List affiliate coupons for a user"
method: GET
path: "/v2/affiliation/{userid}/coupons"
tags: ["Affiliations"]
---

# List affiliate coupons for a user

`GET /v2/affiliation/{userid}/coupons`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/affiliation/{userid}/coupons`
- Auth: none declared

## Path parameters

- `userid` integer, required

## Response `200`

Coupons retrieved successfully

- JsonOkListResponseAffiliateCoupon
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` AffiliateCoupon[]
    - `id` integer: Unique coupon identifier
    - `code` string: Coupon code
    - `uses` integer: Number of times this coupon has been used
    - `creation` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `status` string: Current coupon status: enabled or disabled

## Other responses

- `403`: User not authorized or affiliate is banned

---

[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/cd0ca612fa01?raw)