---
title: "List report runs"
method: GET
path: "/api/reports/{report_id}/runs"
tags: ["Reports"]
---

# List report runs

`GET /api/reports/{report_id}/runs`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/reports/{report_id}/runs`
- Auth: API key in cookie `hk_token`

Lists recent runs and recipient delivery outcomes without rendered bodies or raw SMTP errors.

## Path parameters

- `report_id` string, uuid, required

## Response `200`

Report runs

- ReportRun[]
  - `deliveries` ReportDelivery[]
    - `attempt_count` integer
    - `id` string, uuid
    - `next_attempt_at` string, date-time
    - `recipient_email` string, email
    - `recipient_id` string, uuid
    - `recipient_kind` 'member' | 'external'
    - `recipient_user_id` string, uuid
    - `safe_error_code` string
    - `smtp_accepted_at` string, date-time
    - `status` string
  - `id` string, uuid
  - `period_end` string, date-time
  - `period_start` string, date-time
  - `report_id` string, uuid
  - `safe_error_code` string
  - `scheduled_for` string, date-time
  - `status` string

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)