---
title: "Check availability of an affiliate link identifier"
method: GET
path: "/v2/affiliation/links"
tags: ["Affiliations"]
---

# Check availability of an affiliate link identifier

`GET /v2/affiliation/links`

## Request

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

Checks whether a link hash, destination URL, or link name is already taken. Exactly one of the three query parameters must be provided. Returns 200 with the value if taken, or 404 if available.

## Query parameters

- `hash` string
- `destination` string
- `name` string

## Response `200`

The provided identifier is already taken

- JsonOkResponseString
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` string

## Other responses

- `400`: Not exactly one parameter provided
- `403`: Unauthorized user or affiliate is banned
- `404`: The provided identifier is available

---

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