# List tracked links

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

The workspace's tracked WhatsApp links, newest first, with their
click counter and last click. Filter by campaign (document id or
slug) and status. Requires scope `links:read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `campaign_id` | query | string | no | Campaign document id or `campaign_id` slug. |
| `status` | query | active \| inactive | no |  |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no | Opaque cursor from the previous page's `pagination.next_cursor`. |

## Example request

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

## Responses

### 200: The links

```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"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}
```

### 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": ""
  }
}
```

### 422: Invalid parameter or body (also an invalid or expired `cursor`)

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


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