---
title: "Get a Scheduled Report Run"
method: GET
path: "/reports/scheduled/runs/{objectId}"
tags: ["Reports"]
---

# Get a Scheduled Report Run

`GET /reports/scheduled/runs/{objectId}`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/reports/scheduled/runs/{objectId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/reports/scheduled/runs/:objectId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a Scheduled Report Run by ID.

#### Sample Request
```
curl -X GET https://console.jumpcloud.com/api/v2/reports/scheduled/runs/{object_id} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
```

## Path parameters

- `objectId` string, required

## Response `200`

Success retrieving a Scheduled Report Run.

- JumpcloudInsightsScheduledReportRun
  - `artifactUrl` string, nullable: Presigned download URL when the run succeeded (same link as email/slack notifications). Falls back to a relative API path only when no stored URL exists.
  - `completedAt` string, date-time
  - `displayName` string, nullable: Scheduled report display name (primary label in history UI)
  - `fileSize` string, nullable: File size in bytes
  - `id` string
  - `rowCount` string, nullable: Emitted as string in JSON (e.g. "123"); omit when not set to avoid validation errors.
  - `scheduleFrequency` string, nullable: Stored and returned as lowercase: daily, weekly, monthly, quarterly
  - `scheduleTime` string, nullable: Time of day for the schedule (e.g., "09:00 AM", "14:30")
  - `scheduledReportId` string
  - `startedAt` string, date-time
  - `status` string: Status: IN_PROGRESS, SUCCESS, FAILED
  - `timeZone` string, nullable: Timezone for the schedule (e.g., "GMT-2", "America/New_York")
  - `timeoutAt` string, date-time, nullable: Omit when not set to avoid null (validator expects string or absent).

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)