---
title: "How a short link has been used"
method: GET
path: "/ShortLinks/{id}/Stats"
tags: ["Shortlinks"]
---

# How a short link has been used

`GET /ShortLinks/{id}/Stats`

**Auth:** Authenticated - any signed-in user.

Click totals, a daily breakdown, and where the follows came from. Automated follows (mail scanners, link previewers) are counted separately and excluded by default. Only the link's creator, or IT, may see this. No IP address is ever returned — none is retained past the location lookup.

## Path parameters

- `id` integer, required

## Query parameters

- `includeBots` boolean, required

## Response `200`

Success

- GetShortLinkStatsResponse
  - `shortLinkId` integer
  - `backHalf` string, nullable
  - `redirectLink` string, nullable
  - `totalClicks` integer
  - `botClicks` integer
  - `firstClick` string, date-time, nullable
  - `lastClick` string, date-time, nullable
  - `byDay` GetShortLinkStatsShortLinkDailyCount[]
    - `day` string, date-time
    - `clicks` integer
  - `byCountry` GetShortLinkStatsShortLinkPlaceCount[]
    - `name` string, nullable
    - `clicks` integer
  - `byCity` GetShortLinkStatsShortLinkPlaceCount[]
    - `name` string, nullable
    - `clicks` integer
  - `byReferrer` GetShortLinkStatsShortLinkPlaceCount[]
    - `name` string, nullable
    - `clicks` integer
  - `recent` GetShortLinkStatsShortLinkRecentClick[]
    - `clickedAt` string, date-time
    - `country` string, nullable
    - `city` string, nullable
    - `referrer` string, nullable
    - `isBot` boolean

## Other responses

- `401` — Unauthorized
- `403` — Not your link
- `404` — Not found

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/revisions/5aa4178ca29b/schema)