---
title: "List links of the token's workspace, newest first"
method: GET
path: "/api/v1/links"
tags: ["links"]
---

# List links of the token's workspace, newest first

`GET /api/v1/links`

## Request

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

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

## Query parameters

- `q` string
- `after` integer
- `limit` integer

## Response `200`

Links

- LinkList
  - `data` 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
  - `next_after` integer, nullable: pass as `after` for the next page

---

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