---
title: "List Scheduled Reports"
method: GET
path: "/api/v2/reports/scheduled"
tags: ["Reports"]
---

# List Scheduled Reports

`GET /api/v2/reports/scheduled`

## Request

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

List Scheduled Reports.

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

## Query parameters

- `limit` string, int64
- `skip` string, int64
- `sort` string
- `fields` string[]
- `filter` string[]

## Response `200`

Success listing Scheduled Reports.

- JumpcloudInsightsListScheduledReportsResponse
  - `scheduledReports` JumpcloudInsightsScheduledReport[]
    - `createdAt` string, date-time
    - `cronExpression` string: Generated cron expression (read-only, computed from schedule_frequency, schedule_time, and time_zone)
    - `days` string[]: Weekly: e.g. ["MONDAY", "THURSDAY"]. Monthly/quarterly: ["FIRST_DAY"] or ["LAST_DAY"]. Daily: omit or [].
    - `description` string
    - `displayName` string, required
    - `endDate` string, date-time, nullable: Optional end date for the schedule
    - `exportType` string, required
    - `id` string
    - `isActive` boolean, required
    - `lastRunAt` string, date-time, nullable
    - `lastRunStatus` string
    - `nextRunAt` string, date-time
    - `recipients` JumpcloudInsightsRecipient[], required: List of notification recipients with channel type and recipient details
      - `channelType` string, required
      - `value` string[], required: List of values: email addresses (email), slack channel names/IDs (slack), or webhook URLs (webhook)
    - `reportId` string, byte, nullable: Report definition ID (report_views.object_id or report_templates.object_id); hex in API. Omitted when not set.
    - `reportType` string, nullable: report_view or report_template
    - `scheduleFrequency` string, required
    - `scheduleTime` string, required: Time of day for the schedule (e.g., "09:00 AM", "14:30")
    - `startDate` string, date-time, nullable: Optional start date for the schedule
    - `timeZone` string, required: Timezone for the schedule (e.g., "GMT-2", "America/New_York")
    - `updatedAt` string, date-time
  - `totalCount` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

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