---
title: "Śledzone linki i kliknięcia"
method: GET
path: "/v1/links"
tags: ["Linki"]
---

# Śledzone linki i kliknięcia

`GET /v1/links`

## Request

- Base URL: `https://api.przypominamy.com`
- URL: `https://api.przypominamy.com/v1/links`
- Auth: HTTP bearer

Linki utworzone z placeholdera `{{link:https://…}}` - jeden na parę (odbiorca, adres) - z licznikami kliknięć, od najnowszych. `totals` podsumowuje zwróconą stronę: liczba linków, ile z nich kliknięto choć raz, łączna liczba kliknięć. Wymaga zakresu `read`.

## Query parameters

- `message_id` string
- `clicked` boolean
- `limit` integer

## Response `200`

Lista linków z podsumowaniem

- object
  - `data` TrackedLink[]
    - `token` string: 8 znaków, część adresu `/l/{token}`
    - `short_url` string, uri: Pełny krótki adres; w SMS-ie idzie bez `https://`, żeby oszczędzić znaki
    - `url` string, uri: Adres docelowy z placeholdera
    - `message_id` string, nullable
    - `to` string, nullable: Odbiorca, który dostał ten link
    - `clicks` integer
    - `first_click_at` string, date-time, nullable
    - `last_click_at` string, date-time, nullable
    - `created_at` string, date-time
  - `totals` object
    - `links` integer
    - `clicked` integer: Linki kliknięte co najmniej raz
    - `clicks` integer: Suma kliknięć

## Other responses

- `401`: Brak lub nieprawidłowy klucz API
- `403`: Klucz bez wymaganego zakresu (albo konto zawieszone / testowe wysyła na niezweryfikowany numer)

---

[API](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api.md) · [All operations](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/revisions/c20f9cfc2a7d?raw)