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

# List affiliate links for a user

`GET /v2/affiliation/{userId}/links`

## Request

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

## Path parameters

- `userId` integer, required

## Query parameters

- `status` string

## Response `200`

Links retrieved successfully

- JsonOkListResponseAffiliateLinkDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` AffiliateLinkDto[]
    - `id` integer: Unique identifier of the link
    - `name` string: Display name of the link
    - `slug` string: Slug used to build the public short link
    - `landingPath` string: Landing path on metricool.com the link points to
    - `createdAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `deleted` boolean: Whether the link has been deleted (kept for statistics)

## 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)
