---
title: "Get Report Schedule Runs"
method: GET
path: "/reports/scheduled-reports/{scheduledReportId}/runs"
tags: ["reports"]
---

# Get Report Schedule Runs

`GET /reports/scheduled-reports/{scheduledReportId}/runs`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/reports/scheduled-reports/{scheduledReportId}/runs`
- Auth: HTTP bearer

Use this endpoint to get a list of instances for a scheduled report by it's unique identifier. If the scheduled report requested is not available the response will be a Not Found error. If the scheduled report requested hasn'run yet the response will be an Empty response.

## Path parameters

- `scheduledReportId` string, uuid, required

## Query parameters

- `pageSize` integer
- `pageStartIndex` integer

## Response `200`

OK

- ReportInstanceCollection
  - `count` integer: The total number of items matching the current query.
  - `pageSize` integer: The requested or default page size.
  - `pageStartIndex` integer: The requested or default index of the first element to return.
  - `items` ReportInstance[]
    - `reportId` string: The unique identifier of the report instance.
    - `date` string, date-time: The generation of the report date and time in ISO 8601. https://en.wikipedia.org/wiki/ISO_8601
    - `runInstanceId` string, uuid: The unique identifier of Report Recipient Instance.
    - `recipientsCount` integer: The amount of recipients within the scheduled report instance

## Other responses

- `204`: No Content
- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `416`: Range Not Satisfiable.

## Changes

- **2026-11-03** `443924b00f43`: 4 breaking, 2 warning, 1 info
  - for the `query` request parameter `pageSize`, default value `25` was removed
  - removed the required property `status` from the response with the `416` status
  - removed the required property `title` from the response with the `416` status
  - removed the required property `type` from the response with the `416` status
  - …3 more

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/reports/scheduled-reports/:scheduledReportId/runs/get.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)