---
title: "Get broadcast action link metrics"
method: GET
path: "/v1/broadcasts/{broadcast_id}/actions/{action_id}/metrics/links"
tags: ["Broadcasts"]
---

# Get broadcast action link metrics

`GET /v1/broadcasts/{broadcast_id}/actions/{action_id}/metrics/links`

## Request

- Base URL: `https://api.customer.io`
- URL: `https://api.customer.io/v1/broadcasts/{broadcast_id}/actions/{action_id}/metrics/links`
- Auth: HTTP bearer

Returns link click metrics for an individual broadcast action. Unless you specify otherwise, the response contains data for the maximum period by days (45 days).

You cannot request fewer than 2 steps of any period (2 hours, 2 days, 2 weeks, or 2 months). For instance, `?period=days&steps=1` means two days - the 48 hours before the API request was made. `?period=days&steps=0` returns the same as the maximum of the period - `?period=days&steps=45`. See the `steps` parameter below for the maximum count of each period.

## Response `200`

Returns broadcast variant metrics by `series` (with increments are based on the `period` and `step` in your request) for the broadcast.

- object
  - `links` LinkMetrics[]: Each object in the array represents a link in your broadcast variant.
    - `link` object
      - `id` integer: The ID of the link.
      - `href` string: The link destination—a URL, mailto, etc.
    - `metric` object: Contains metrics for the link.
      - `series` object
        - `clicked` integer[]: An array of results from oldest to newest, where each result indicates a period.
        - `human_clicked` integer[]: An array of human click counts (clicks excluding machine clicks) from oldest to newest, where each result indicates a period. This metric is reliable starting April 20, 2025. [Learn more](/messaging/metrics/analytics/#delivery-metrics).
        - `machine_clicked` integer[]: An array of machine click counts (clicks attributed to bots or prefetching) from oldest to newest, where each result indicates a period. This metric is reliable starting April 20, 2025. [Learn more](/messaging/metrics/analytics/#delivery-metrics).

## Other responses

- `400`: The `broadcastID`, `actionID` or `triggerID` is invalid.
- `404`: The broadcast, action, and/or trigger do not exist.
- `429`: Your request is over the 10-per-second limit. `Retry-After` tells you how many seconds you must wait before you send the next request.

## Changes

- **2026-09-02** `5da2740beeb5`: 1 info
  - added the media type `application/json` for the response with the status `429`

[Operation history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/broadcasts/:broadcast_id/actions/:action_id/metrics/links/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) - [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/revisions/ac0b282053fe?raw)