---
title: "List short links"
method: GET
path: "/short-links"
tags: ["Short links"]
---

# List short links

`GET /short-links`

## Request

- Base URL: `https://api.multi-upload-tool.com/api/v1`
- URL: `https://api.multi-upload-tool.com/api/v1/short-links`
- Auth: API key in header `x-api-key`

Returns the caller's short links with their click counts.

## Query parameters

- `page` integer
- `limit` integer

## Headers

- `X-Team-ID` integer

## Response `200`

The caller's short links.

- object
  - `success` unknown
  - `data` ShortLink[]
    - `id` integer
    - `slug` string
    - `url` string, uri
    - `shortUrl` string, uri: The full short URL, on the default or custom domain.
    - `title` string, nullable
    - `description` string, nullable
    - `imageUrl` string, uri, nullable
    - `domainId` integer, nullable
    - `useDeeplink` boolean
    - `botProtection` boolean
    - `safeUrl` string, uri, nullable
    - `clicks` integer
    - `rules` ShortLinkRule[]
      - `type` 'geo' | 'device' | 'language' | 'time' | 'referer', required
      - `destination` string, uri, required
      - `countryCodes` string: Comma-separated ISO 3166-1 alpha-2 codes.
      - `languages` string
      - `devices` string
      - `referers` string
      - `startTime` string
      - `endTime` string
      - `days` string
      - `timezone` string
      - `priority` integer
      - `useDeeplink` boolean
      - `isActive` boolean
    - `createdAt` string, date-time

## Other responses

- `401`: The API key is missing, invalid, revoked or expired.
- `429`: Too many requests for this endpoint group.

---

[API](https://skmtc.dev/multi-upload-tool/apis/multi-upload-tool-api.md) · [All operations](https://skmtc.dev/multi-upload-tool/apis/multi-upload-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/multi-upload-tool/apis/multi-upload-tool-api/revisions/bb7e72abbb76?raw)