The report run object

A report run tracks the lifecycle of a generated report. After creation, the run moves from generating to completed or failed. Completed runs include a result object with a URL to download the artifact.

{
  "id": "run_Bw6EkMDmxCPeVQ2eYzLu",
  "report": "payroll_journal",
  "status": "completed",
  "company": "com_sx3svU6K8c5ZkSFlOh5p",
  "created_at": "2026-06-24T18:26:56.848920Z",
  "completed_at": "2026-06-24T18:27:12.123456Z",
  "parameters": {
    "payday_from": "2025-01-01",
    "payday_to": "2025-03-31"
  },
  "result": {
    "url": "https://api.checkhq.com/report_runs/run_Bw6EkMDmxCPeVQ2eYzLu/download"
  },
  "metadata": {}
}

Attribute	Description
`id` string	Unique identifier for the report run.
`report` string	The report type. One of `payroll_journal` or `payroll_summary`.
`status` string	One of `generating`, `completed`, or `failed`.
`company` string or null	ID of the company the report is scoped to. Required for some report types.
`created_at` timestamp	Time at which the report run was created.
`completed_at` timestamp or null	Time at which the report run finished generating. `null` while the status is `generating`.
`parameters` object or null	Report-specific parameters supplied at creation. For `payroll_journal` and `payroll_summary`, includes `payday_from`, `payday_to`, and optional fields such as `payroll`, `group_by`, `contractors`, `taxable_wages`, `gross_taxable_wages`, and `additional_columns`.
`result` object or null	Present when a downloadable artifact exists. Contains `url`, an absolute URL to download the report run. Download URLs are short-lived. `null` while the report is still generating or if generation failed.
`metadata` object	Additional loosely structured information associated with the report run.