---
title: "GET an Email Links Report"
method: GET
path: "/reports/email_reports/{campaign_activity_id}/links"
tags: ["Email Reporting"]
---

# GET an Email Links Report

`GET /reports/email_reports/{campaign_activity_id}/links`

## Request

- Base URL: `https://api.cc.email/v3`
- URL: `https://api.cc.email/v3/reports/email_reports/{campaign_activity_id}/links`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://authz.constantcontact.com/oauth2/default/v1/authorize`
    - Scopes: `campaign_data`
  - OAuth 2
    - Authorization code: `https://authz.constantcontact.com/oauth2/default/v1/authorize`
    - Token URL: `https://authz.constantcontact.com/oauth2/default/v1/token` scopes: `campaign_data`

Use this method to return link details, including the number of unique contacts that clicked each link in an email campaign activity, and the type of action associated with clicking each link. To include link details for links that were not clicked, set the `no_clicks` query parameter to `true`.

You can return reporting data for `primary_email` and `resend` role email campaign activities. For more use case information, see [Get an Email Links Report](/api_guide/email_links_report.html) in the API guide.

## Path parameters

- `campaign_activity_id` string, uuid, required

## Query parameters

- `no_clicks` boolean

## Response `200`

Request was successful

- EmailLinks
  - `campaign_activity_id` string, uuid: The unique ID for an email campaign activity.
  - `link_click_counts` EmailLinkClickCount[]: An array of objects that contain the contact click count and link metadata for each unique link URL in an email campaign activity. By default, this method combines results for duplicate link URLs.
    - `link_url` string: The URL of a link in an email campaign activity. This URL is not normalized and appears the same as the URL in the email campaign activity.
    - `url_id` string: The ID for a unique link URL in an email campaign activity.
    - `unique_clicks` integer: The number of unique contacts that clicked the link.
    - `list_action` string: If the link uses the click segmentation feature, this property contains the action that contacts trigger when they click the link. Currently the only available action is <code>add</code>, which adds contacts that click the link to a contact list.
    - `list_id` string, uuid: If the link uses the click segmentation feature, this property contains the contact list linked with the <code>list_action</code> property.
    - `link_tag` string: Link tags are not currently available in email campaigns. By default, this method combines results for duplicate link URLs. Link tags will allow users to get a separate link click report for each unique <code>link_tag</code> value they use, even if URLs are not unique.

## Other responses

- `400`: Bad request. Either the JSON was malformed or there was a data validation error.
- `401`: The Access Token used is invalid.
- `403`: Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404`: The requested resource was not found.
- `415`: Unsupported Media Type.
- `500`: There was a problem with our internal service.

## Changes

- **2025-07-26** `2483585c5d89`: 1 info
  - the endpoint scheme security `api_key` was removed from the API
- **2022-10-08** `fb537b06c1da`: 1 info
  - added the new optional `query` request parameter `no_clicks`
- **2019-11-22** `30feb0ca4138`: 1 info
  - added the non-success response with the status `400`

[Operation history](https://skmtc.dev/cc/apis/appconnect-v3/changes/reports/email_reports/:campaign_activity_id/links/get.md)

---

[API](https://skmtc.dev/cc/apis/appconnect-v3.md) - [All operations](https://skmtc.dev/cc/apis/appconnect-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/cc/apis/appconnect-v3/revisions/7bcad1d0ff26?raw)