# Get a tracked link with its stats

`GET https://app.whatsetter.com/api/v1/links/{id}`

One link plus `stats_30d`, the numbers of the dashboard drawer:
`clicks` and `by_channel` over the last 30 days (platform read on each
click; `direct` = no platform signature), `leads` and `qualified` =
every conversation the link brought, all time. Requires scope
`links:read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes |  |

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/links/{id}' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The link and its stats

```json
{
  "data": {
    "id": "68d9aa11bb22cc33dd44ee55",
    "slug": "insta-bio",
    "name": "Instagram bio",
    "url": "https://app.whatsetter.com/l/insta-bio",
    "campaign_id": "auto24-maroc-4-bu76",
    "status": "active",
    "channel": "auto",
    "clicks": 128,
    "last_click_at": "2026-09-18T10:00:00.000Z",
    "created_at": "2026-09-01T08:00:00.000Z",
    "stats_30d": {
      "clicks": 128,
      "by_channel": {
        "instagram": 90,
        "tiktok": 30,
        "direct": 8
      },
      "leads": 41,
      "qualified": 12
    }
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/getlink/
