---
title: "Get Campaign Logs"
method: GET
path: "/v1/campaigns/{id}/logs"
tags: ["Campaigns"]
---

# Get Campaign Logs

`GET /v1/campaigns/{id}/logs`

List per-recipient delivery and engagement logs for a campaign, newest first. Cursor-paginated. Rows come from the tracking worker (D1) and use snake_case field names. Requires API key with campaign:read.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'delivered' | 'opened' | 'clicked' | 'bounced' | 'spam_report'

## Response `200`

Campaign logs

- ApiResponseCampaignLogs
  - `success` boolean, required
  - `data` object, nullable
    - `emails` CampaignLog[], required
      - `to_email` string — Recipient email address.
      - `subject` string, nullable — Subject line as sent.
      - `status` string — Delivery status, e.g. delivered, bounced, complained, suppressed.
      - `opened_at` string, date-time, nullable — First open timestamp, or null if not opened.
      - `clicked_at` string, date-time, nullable — First click timestamp, or null if not clicked.
      - `open_count` integer — Number of recorded opens.
      - `click_count` integer — Number of recorded clicks.
      - `bounce_type` string, nullable — Bounce classification when the row bounced, e.g. hard or soft.
      - `complaint_type` string, nullable — Complaint classification when the recipient reported the message.
      - `campaign_id` string — Campaign this row belongs to.
      - `created_at` string, date-time — When the send was logged.
    - `nextCursor` string, nullable, required — Cursor for the next page, or null when there are no more rows.
    - `hasMore` boolean, required
  - `error` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/2d06ad0e0bc3/schema)