---
title: "List recent comment campaign evaluations"
method: GET
path: "/api/campaigns/comment-events"
tags: ["Campaigns"]
---

# List recent comment campaign evaluations

`GET /api/campaigns/comment-events`

## Request

- Base URL: `https://api.setluca.com`
- URL: `https://api.setluca.com/api/campaigns/comment-events`
- Auth: one of:
  - API key in cookie `luca.session_token`
  - API key in header `x-api-key`
  - HTTP bearer

Latest filtered campaign evaluations with totals across every matching event, including suppressed comments and their reasons.

**API key scopes:** `campaigns:read`.

## Query parameters

- `campaignId` string, uuid
- `cursor` string
- `status` 'matched' | 'suppressed' | 'blocked' | 'pending_review' | 'sent' | 'failed' | 'enrolled' | 'replayed' | 'resolved'
- `sourceType` string
- `tokenState` 'valid' | 'expired' | 'missing_scope' | 'unknown'
- `providerHealth` 'green' | 'yellow' | 'red' | 'unknown'
- `repairState` string
- `q` string
- `limit` integer

## Headers

- `Luca-API-Version` '1'

## Response `200`

ok

- CampaignCommentEventListResponse
  - `events` object[], required
    - `id` string, uuid, required
    - `campaignId` string, uuid, required
    - `campaignVersionId` string, uuid, nullable, required
    - `enrollmentId` string, uuid, nullable, required
    - `leadId` string, uuid, nullable, required
    - `channelAccountId` string, uuid, nullable, required
    - `externalUserId` string, required
    - `providerMessageId` string, required
    - `externalCommentId` string, nullable, required
    - `externalPostId` string, nullable, required
    - `externalAdId` string, nullable
    - `externalLiveSourceId` string, nullable
    - `sourceType` string
    - `triggerNodeId` string, required
    - `status` 'matched' | 'suppressed' | 'blocked' | 'pending_review' | 'sent' | 'failed' | 'enrolled' | 'replayed' | 'resolved', required
    - `priority` string
    - `suppressionReason` string, nullable, required
    - `body` string, required
    - `matchResult` unknown, required
    - `matchExplanation` string, nullable
    - `sourceMetadata` unknown, required
    - `providerSnapshot` unknown
    - `aiClassification` unknown
    - `actionStatuses` unknown
    - `safetyNotes` unknown
    - `commenterIdentityStatus` string
    - `commenterDisplayName` string, nullable
    - `language` string, nullable
    - `rawSnapshotRedacted` boolean
    - `repairState` string
    - `parentEventId` string, uuid, nullable
    - `primaryReviewQueueId` string, uuid, nullable
    - `primaryOutboxId` string, uuid, nullable
    - `resolvedAt` string, nullable
    - `createdAt` string, required
  - `analytics` object, required
    - `total` integer, required
    - `matched` integer, required
    - `suppressed` integer, required
    - `blocked` integer, required
    - `sent` integer, required
    - `failed` integer, required
    - `conversionRate` number, required
    - `failureRate` number, required
    - `topSuppressionReasons` object[], required
      - `reason` string, required
      - `count` integer, required
    - `providerIssues` object[], required
      - `issue` string, required
      - `count` integer, required
    - `liveVsSimulation` object, required
      - `expectedSuiteStatus` union, required
        - 'missing' | 'stale' | 'failed' | 'passed'
        - 'unknown'
      - `liveEvents` integer, required
      - `liveFailuresOrBlocks` integer, required
      - `liveFailureOrBlockRate` number, required
      - `summary` string, required
  - `receiptAudit` object, nullable
    - `received` integer, required
    - `withoutDecision` integer, required
    - `receipts` object[], required
      - `id` string, uuid, required
      - `providerMessageId` string, required
      - `externalCommentId` string, nullable, required
      - `externalUserId` string, required
      - `externalPostId` string, nullable, required
      - `body` string, required
      - `receivedAt` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: bad request
- `401`: unauthorized
- `429`: rate limited
- `500`: internal error
- `503`: service unavailable

---

[API](https://skmtc.dev/setluca/apis/luca-api.md) · [All operations](https://skmtc.dev/setluca/apis/luca-api/llms.txt) · [OpenAPI document](https://skmtc.dev/setluca/apis/luca-api/revisions/90a200e4100b?raw)