---
title: "Get campaign report"
method: GET
path: "/v1/creator-campaigns/{campaignId}/report"
tags: ["Creator Campaigns"]
---

# Get campaign report

`GET /v1/creator-campaigns/{campaignId}/report`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/creator-campaigns/{campaignId}/report`
- Auth: HTTP bearer

Returns spend against budget, views, submission counts, the top ten participants by earnings
and the authenticity score distribution.

## Path parameters

- `campaignId` string, required

## Response `200`

Campaign report

- object
  - `report` CampaignReport, required
    - `spend` object, required
      - `budgetCents` integer, required
      - `consumedCents` integer, required
      - `settledCents` integer, required
    - `views` object, required: Summed over submissions that are not rejected or withdrawn.
      - `eligible` integer, required: Views that count toward earnings.
      - `total` integer, required: Latest view counts.
      - `paid` integer, required: Views from ads, on YouTube and X posts.
    - `engagements` integer, required: The campaign engagement types summed over the same submissions.
    - `submissions` CampaignSubmissionCounts, required: Number of submissions in each status.
      - `received` integer, required
      - `tracking` integer, required
      - `pending_review` integer, required
      - `approved` integer, required
      - `rejected` integer, required
      - `expired` integer, required
      - `withdrawn` integer, required
    - `participants` object[], required: Top 10 participants by payable, settling and settled cents.
      - `participantId` string, required
      - `creator` object, required
        - `id` string, required
        - `displayName` string, required
      - `payableCents` integer, required
      - `settlingCents` integer, required: A treasury payout in progress.
      - `settledCents` integer, required
    - `authenticity` object[], required: Authenticity score histogram in ten buckets (0-9 through 90-100).
      - `from` integer, required
      - `to` integer, required
      - `count` integer, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: Refused. Code `feature_not_available`: creator campaigns run on usage-based billing and the workspace that owns the campaign is not on it yet ("Creator campaigns require usage-based billing..."; contact support to switch), or the campaign reached `caps.maxParticipants` (invites and joins only). Code `insufficient_permissions`: a restricted API key without the `creator_campaigns` resource group.
- `404`: The campaign, participant or submission does not exist, belongs to another team, or sits in a profile this key cannot reach (code `resource_not_found`).

## Changes

- **2026-10-30** `c319eb5d95b6`: 1 info
  - added the required property `report/views/paid` to the response with the `200` status
- **2026-10-30** `172499a6a5e9`: 1 info
  - added the required property `report/engagements` to the response with the `200` status
- **2026-10-28** `8f2c44dd7550`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/creator-campaigns/:campaignId/report/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/c319eb5d95b6?raw)