---
title: "GET /v2/clicks"
method: GET
path: "/v2/clicks"
tags: ["clicks-v2"]
---

# GET /v2/clicks

`GET /v2/clicks`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/clicks`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `limit` string
- `cursor` string
- `end_date` string, required
- `start_date` string, required
- `list_number` string
- `sending_list_id` string
- `phone_number` string, required

## Response `200`

Success

- ClicksListResponse
  - `clicks` ClickEvidenceRow[]
    - `click_id` string: Attribution click ID; null for bot/preview or legacy events
    - `ip_address` string: IP address recorded for the click request
    - `message_body` string: Recorded body of the sent message
    - `message_id` string: Message ID containing the clicked link
    - `timestamp` string: Click timestamp (ISO8601 UTC)
  - `pagination` ClicksV2Pagination
    - `has_more` boolean: Whether another page is available
    - `limit` integer: Page size
    - `next_cursor` string: Opaque cursor for the next page; null on the last page

## Other responses

- `400`: Validation error
- `401`: Authentication error
- `403`: Account suspended
- `429`: Rate limit exceeded
- `500`: Query failed

---

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