DoubleVerify icon

DoubleVerify

Interact with the DoubleVerify Report Data API

Actions11

Report → Create Request

AI-generated

Summary

Submits an asynchronous report data request to the DoubleVerify Report Data API (POST /requests) for a request type, date range, and set of metrics. It returns the API's response for the new request, which you then poll with Get Status and download with Fetch Data.

Inputs

  • Request Type ID (required) — Numeric ID of the DoubleVerify request type (default 1). Sent as requestType.
  • Date From (required) — Start of the report range, ISO 8601. Sent as dateRange.from.
  • Date To (required) — End of the report range, ISO 8601. Sent as dateRange.to.
  • Metrics (JSON) (required) — JSON array of metric objects. Each needs an ID (number) and may include name, filterValues, includeFilterValues, filterValuesType, includeInReport. Parsed with JSON.parse, so invalid JSON causes an error.
  • Additional Options: Dimensions (JSON) — JSON array of dimension objects, added to the body as dimensions when set.
  • Additional Options: Time Zone — IANA time zone such as America/New_York, sent as timeZone when non-empty. Valid values are listed in Request Type Details.
  • Additional Options: Metric Thresholds (JSON) — JSON object with operator, children, metricId, and value fields, sent as metricThresholds when set.

Output shape

One output item per input item, containing the JSON response from DoubleVerify for the created request. If the API returns an array, each element becomes its own item.

The response is expected to identify the report request, which is the Report Request ID used by Get Status and Fetch Data. The exact fields are not defined in the node. The API call does not return the report data itself. With Continue On Fail enabled, errors are returned as { error: message } items.

Examples

Example 1: Request last week's report for a request type with two metrics

Request Type ID=1, Date From/To set to the week's bounds, Metrics=[{"ID":10},{"ID":11}]

Example 2: Break a report down by dimension in a specific time zone

Required fields plus Additional Options: Dimensions=[{"ID":5}], Time Zone=America/New_York

Example 3: Run a full async report pipeline

Create Request, then a Wait node, then Get Status, then Fetch Data once the status is Success, passing the request ID between steps

Links

Discussion