---
title: "One link"
method: GET
path: "/api/v1/links/{id}"
tags: ["links"]
---

# One link

`GET /api/v1/links/{id}`

## Request

- Base URL: `https://app.utmkit.co`
- URL: `https://app.utmkit.co/api/v1/links/{id}`
- Auth: HTTP bearer

Requires a token with the `links:read` permission.

## Path parameters

- `id` integer, required

## Response `200`

Link

- Link
  - `android_url` string, nullable
  - `campaign_id` integer, nullable
  - `created_at` string, date-time
  - `created_by` object
    - `api_token_id` integer, nullable
    - `user_id` integer
  - `destination` string
  - `expires_at` string, date-time, nullable
  - `id` integer
  - `ios_url` string, nullable
  - `note` string, nullable
  - `qr_url` string, uri: the short URL with the scan marker
  - `short_code` string
  - `short_url` string, uri
  - `state` 'live' | 'pending' | 'blocked' | 'expired'
  - `tags` object[]: the link's tags, by name without regard to case
    - `color` 'gray' | 'red' | 'orange' | 'amber' | 'green' | 'teal' | 'blue' | 'purple'
    - `name` string
  - `utm_campaign` string, nullable
  - `utm_content` string, nullable
  - `utm_medium` string, nullable
  - `utm_source` string, nullable
  - `utm_term` string, nullable

## Other responses

- `404`: Error

---

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