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

# List short link metrics

`GET /v1/short-links/metrics`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/short-links/metrics`
- Auth: HTTP bearer

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>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.

## Changes

- **2026-09-08** `6a89c962481c`: 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/ShortLinkMetricsResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - …2 more
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-05-08** `ce71f60fb356`: 5 breaking
  - the response property `allOf[subschema #1: ShortLinkMetricsResponse]/metrics/items/browser` became nullable for the status `200`
  - the response property `allOf[subschema #1: ShortLinkMetricsResponse]/metrics/items/language` became nullable for the status `200`
  - the response property `allOf[subschema #1: ShortLinkMetricsResponse]/metrics/items/operating_system` became nullable for the status `200`
  - the response property `allOf[subschema #1: ShortLinkMetricsResponse]/metrics/items/phone` became nullable for the status `200`
  - …1 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/short-links/metrics/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)