---
title: "List all reports"
method: GET
path: "/martech/{connection_id}/report"
tags: ["martech", "report"]
---

# List all reports

`GET /martech/{connection_id}/report`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/martech/{connection_id}/report`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string, date-time
- `sort` 'name' | 'updated_at' | 'created_at'
- `order` 'asc' | 'desc'
- `query` string
- `campaign_id` string
- `list_id` string
- `start_gte` string
- `end_lt` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- MarketingReport[]
  - `id` string: Unique identifier for the campaign report
  - `start_at` string, date-time: Start time (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `end_at` string, date-time: End time (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `campaign_id` string: Associated campaign ID
  - `list_id` string: Associated list ID
  - `emails_sent` number: Total emails sent
  - `abuse_reports` number: Number of abuse reports
  - `unsubscribed` number: Number of unsubscribes
  - `sent_at` string, date-time: Send time (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `hard_bounces` number: Hard bounce count
  - `soft_bounces` number: Soft bounce count
  - `syntax_errors` number: Syntax error count
  - `forwards_count` number: Forward count
  - `forwards_opens` number: Forwards opened
  - `opens_total` number: Total opens
  - `unique_opens` number: Unique opens
  - `open_rate` number: Open rate (decimal)
  - `last_open_at` string, date-time: Last open timestamp (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `clicks_total` number: Total clicks
  - `unique_clicks` number: Unique clicks
  - `unique_subscriber_clicks` number: Unique subscriber clicks
  - `click_rate` number: Click rate (decimal)
  - `last_click_at` string, date-time: Last click timestamp (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `links` MarketingReportLink[]: URL-specific click data
    - `url` string: The URL
    - `total_clicks` number: Total clicks on this link
    - `click_percentage` number: Percentage of total clicks
    - `unique_clicks` number: Unique clicks on this link
    - `unique_click_percentage` number: Percentage of unique clicks
    - `last_click_at` string, date-time: Last click timestamp (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `human_opens_total` number: Total opens excluding automated/bot/proxy (e.g. Apple Mail Privacy Protection) opens
  - `human_unique_opens` number: Unique opens excluding automated/bot/proxy opens
  - `human_open_rate` number: Open rate (decimal) excluding automated/bot/proxy opens
  - `metadata` MarketingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)