# ReportRunRequestDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

What to run a report over: a calendar date range read in a time zone, an optional merchant, and
the report's own filters.

## Fields
- `startDate` (string(date)) required: The first calendar day to include, for example `2026-03-01`. Read as a day in  `timeZoneId`, and included whole.
- `endDate` (string(date)) required: The last calendar day to include, for example `2026-03-31`. Included whole: the run covers  up to the first instant of the next day in `timeZoneId`. Must not be before  `startDate`, and the range may cover at most 366 days. Conditional: When EndDate >= StartDate.
- `timeZoneId` (string): The IANA time zone the dates are calendar days in, for example `America/Los_Angeles`.  Reports that group rows by day group them by this zone's day. Optional: the dates are UTC days  when it is omitted. Conditional: When TimeZoneId is not empty. (nullable, max length 64)
- `merchantId` (string(uuid)): Narrows the run to one merchant the caller can read. Optional: the run covers every merchant  the caller can read when it is omitted. Refused for a report whose catalog entry does not  support a merchant, and for a merchant outside the caller's scope. Conditional: When MerchantId is not null. (nullable)
- `filters` (object): The report's filters, keyed by the names its parameters route lists. A filter that allows  multiple values takes an array; every other filter takes a single value. Optional. Conditional: When Filters is not null. (nullable)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.