---
title: "List short link metrics"
method: GET
path: "/v1/short-links/metrics"
tags: ["Link shortener"]
---

# List short link metrics

`GET /v1/short-links/metrics`

Returns per-click metrics for short links, including device, location, and campaign attribution, within the requested date range.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `phone` string
- `utm_campaign` string
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of short link metrics.

- ShortLinkMetricsResponse
  - `metrics` ShortLinkMetricsItem[], required — List of short link metrics matching search criteria.
    - `latitude` number, nullable, required — Latitude of the location derived from the IP address used to open the short link.
    - `longitude` number, nullable, required — Longitude of the location derived from the IP address used to open the short link.
    - `operating_system` string, nullable, required — Operating system of the device that opened the short link.
    - `browser` string, nullable, required — Browser used to open the short link.
    - `language` string, nullable, required — Browser language preference.
    - `phone` string, nullable, required — Phone number associated with the short link.
    - `utm_campaign` string, nullable, required — UTM campaign name associated with the short link.
    - `created_at` string, required — Date and time when short link was opened.
    - `link_hash` string, required — Hash of the short link.
    - `user_id` integer, required — Account ID.
  - `pagination` Pagination, required
    - `current_page` integer, required — Current page number.
    - `per_page` integer, required — Number of records per page.
    - `total` integer, required — Total number of records.
    - `total_pages` integer, required — Total number of pages.

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.

---

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