---
title: "Event-level report"
method: POST
path: "/measurement/campaigns/{campaign_id}/events_report"
tags: ["Queries"]
---

# Event-level report

`POST /measurement/campaigns/{campaign_id}/events_report`

Creates an event-level reporting query for a campaign. Output is a CSV of raw event data based on the parameters selected. The report is produced asynchronously; poll the returned async query or provide a `callbackUrl` to be notified on completion.

## Path parameters

- `campaign_id` string, required

## Request body

- object
  - `startDate` string, date, required — A start date in YYYY-MM-DD format.
  - `endDate` string, date, required — An end date in YYYY-MM-DD format.
  - `timezone` string — The timezone used to interpret the date range. Defaults to the campaign's configured time zone (or UTC).
  - `attributionWindow` 1 | 3 | 7 | 14 | 30 | 60 | 90 — How many days after an exposure a related conversion/response event may be attributed to it. (Allowed: 1/3/7/14/30/60/90 | defaults to campaign setting or 30)
  - `attributionMethodology` 'last_touch' | 'equal_credit' | 'equal_credit_adjusted_display_weight' — Methodology option between last_touch, equal_credit, and equal_credit_adjusted_display_weight. If blank or broadcast, defaults to campaign setting (or last_touch).
  - `dateFilterSource` 'exposure' | 'event' — Export filter option by exposure date or event date. Defaults to campaign setting (or exposure).
  - `eventTypes` string[] — Event type filters. Allowed values include: view, identify, lead, product, add_to_cart, checkout, code, purchase, listen_link_click, install. Defaults to all.
  - `ronDynamicBreakout` boolean — Breakout RON & Dynamic line items in the report. Defaults to false.
  - `recursivePayloadDestructure` boolean — Select whether you would like to destructure the payload recursively. Defaults to false.
  - `youtubeOnly` boolean — Limit the report to YouTube line items when YouTube is enabled for the campaign. Defaults to false.
  - `usExposuresOnly` boolean — Limit the report to US exposures only. Defaults to false.
  - `includeMatchSource` boolean — Include a matched_source column in the report indicating how each event was matched (e.g. ip, household, etc.). Defaults to false.
  - `includePublisherClientName` boolean — Include a publisher_client_name column in the report identifying the publisher client associated with each line item (dynamic ad, baked-in ad, etc.). Defaults to false.
  - `callbackUrl` string, uri — HTTPS URL to receive completion/failure events.

## Response `200`

OK — report enqueued. The response echoes back the resolved report parameters alongside the async query status.

- EventReportAsyncExport — Async export for an event-level report query. Echoes back the resolved report parameters alongside the export status.
  - `id` integer, required — Unique identifier for the async export.
  - `callbackUrl` string, uri, nullable — The callback URL provided in the request, if any.
  - `campaignId` string, required — The campaign identifier.
  - `attributionMethodology` string — The attribution methodology used for the report.
  - `attributionWindow` integer — The attribution window in days.
  - `lastNDays` integer, nullable — Rolling date range in days. Null when a fixed date range is used.
  - `dateFilterSource` string — Whether the date range was applied to exposure dates or event dates.
  - `startDate` string, date — The start date of the report.
  - `endDate` string, date — The end date of the report.
  - `eventTypes` string[] — The event types included in the report.
  - `timezone` string — The timezone used for the report.
  - `ronDynamicBreakout` boolean — Whether RON & Dynamic line items are broken out.
  - `recursivePayloadDestructure` boolean — Whether payload is recursively destructured.
  - `youtubeOnly` boolean — Whether the report is limited to YouTube line items.
  - `usExposuresOnly` boolean — Whether the report is limited to US exposures.
  - `includeMatchSource` boolean — Whether the matched_source column is included in the report.
  - `includePublisherClientName` boolean — Whether the publisher_client_name column is included in the report.
  - `status` 'PENDING' | 'RUNNING' | 'COMPLETE' | 'FAILED', required — Current status of the report.
  - `results` string, uri — Download URL for the CSV report. Only present when status is COMPLETE.

## Other responses

- `302` — Duplicate query found — returns the original async export instead of creating a new one.
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Content

---

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