# RecurringBillingRunSummaryDto

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

Summary DTO for a recurring billing run, used in history grid views.

## Fields
- `id` (string(uuid)): The document ID.
- `runId` (string(uuid)): Links all per-merchant run documents from the same workflow execution.
- `merchantId` (string(uuid)): The merchant this run was executed for.
- `runDate` (string(date-time)): The business date of this billing run.
- `triggerType` ([RecurringBillingTriggerType](https://devportal.demo.winkpg.io/docs/api/models/RecurringBillingTriggerType.md)): Whether this run was auto or manually triggered.
  Values:
  - `Auto`: Triggered automatically by the scheduled cron job.
  - `Manual`: Triggered manually by an administrator via the API or UI.
- `contractCount` (integer(int32)): Number of contracts processed.
- `successCount` (integer(int32)): Number of successful billing attempts.
- `failedCount` (integer(int32)): Number of failed billing attempts.
- `skippedCount` (integer(int32)): Number of skipped contracts (already billed).
- `totalAmount` (number(double)): Total amount billed across all contracts.
- `status` ([RecurringBillingRunStatus](https://devportal.demo.winkpg.io/docs/api/models/RecurringBillingRunStatus.md)): Execution status.
  Values:
  - `Pending`: The run has been created but not yet started.
  - `Running`: The run is currently executing.
  - `Completed`: All contracts in the run were processed successfully.
  - `Failed`: The run failed entirely (infrastructure or unrecoverable error).
  - `PartiallyCompleted`: Some contracts succeeded and some failed.
- `correlationId` (string(uuid)): Correlation identifier for distributed tracing. (nullable)
- `durationMs` (integer(int64)): Total duration of the run in milliseconds. (nullable)
- `creationTime` (string(date-time)): When this run was created.

## See also

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