Skip to main content
GET
Returns individual short-link click requests recorded for one recipient and one sending list owned by the API-key account. Results are newest first.
A row proves that Trackly recorded an HTTP request from the returned IP address. It does not prove who operated the device, that the request was human, or that the recipient consented. Link-preview and security scanners can generate requests. A non-null click_id was generated only for requests classified as non-bot; a null value can also indicate legacy data.

Query Parameters

string
required
Recipient phone number in E.164 format.
integer
Sending list ID. Either this field or list_number is required. When both are supplied, sending_list_id takes precedence.
string
Sending list phone number in E.164 format. Required when sending_list_id is omitted.
string
required
Inclusive UTC start date in YYYY-MM-DD format.
string
required
Inclusive UTC end date in YYYY-MM-DD format. The inclusive range cannot exceed 30 calendar days.
string
Opaque pagination cursor from a previous response’s next_cursor.
integer
default:"50"
Page size, max 200.

Response Fields

array
Individual recorded click requests.
object
limit, has_more (boolean), and next_cursor (opaque, null on the last page).

Examples

An unknown or unowned sending list returns an empty clicks page rather than revealing whether another account owns it. Requests are limited to 60 per minute per API key unless that key has a custom rate-limit override.

Error Codes

Also 401 invalid_credentials and 403 account_suspended.