---
title: "List clicked links"
method: GET
path: "/v1/emails/clicked-links"
tags: ["Emails"]
---

# List clicked links

`GET /v1/emails/clicked-links`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/emails/clicked-links`
- Auth: HTTP bearer

Clicked links across all email over the last N days, ranked by clicks, with unique clicks (distinct emails). Pass url for one link's totals, daily series and the emails it was clicked in. Not in Resend, which lists clicked links per broadcast only. Requires the email:read scope.

## Query parameters

- `days` integer
- `domain_id` string
- `url` string

## Response `200`

Links, or one link in detail

- object

## Other responses

- `400`: Bad request - check your payload
- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

[API](https://skmtc.dev/smtpfa/apis/smtpfast-api.md) · [All operations](https://skmtc.dev/smtpfa/apis/smtpfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smtpfa/apis/smtpfast-api/revisions/79dda742f53e?raw)