---
title: "List dataset report schedules"
method: GET
path: "/api/v2/reporting/dataset/{dataset_id}/schedules"
tags: ["Report Schedules"]
---

# List dataset report schedules

`GET /api/v2/reporting/dataset/{dataset_id}/schedules`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/reporting/dataset/:dataset_id/schedules/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all report schedules for a given published dataset.
Returns report schedules belonging to the authenticated user's organization that target the specified dataset.
Requires the `generate_log_reports` or `manage_log_reports` permission.

## Path parameters

- `dataset_id` string, required

## Response `200`

OK

- DatasetReportScheduleListResponse: Response containing a list of report schedules for a published dataset.
  - `data` DatasetReportScheduleResponseData[], required: A list of report schedules for the dataset.
    - `attributes` DatasetReportScheduleResponseAttributes, required: The configuration and derived state of a report schedule for a published dataset.
      - `cell_id` string, nullable, required: The identifier of the notebook cell that published the dataset, or `null` if not set.
      - `dataset_id` string, nullable, required: The identifier of the dataset, or `null` if not set.
      - `description` string, required: The description of the report.
      - `file_row_limit` integer, nullable, required: The maximum number of rows included in the attached CSV file, or `null` if not set.
      - `inline_row_limit` integer, nullable, required: The maximum number of rows included inline in the email body, or `null` if not set.
      - `next_recurrence` integer, nullable, required: The Unix timestamp, in milliseconds, of the next scheduled delivery, or `null` if none is scheduled.
      - `notebook_id` integer, nullable, required: The identifier of the notebook containing the dataset cell, or `null` if not set.
      - `recipients` string[], required: The recipients of the report (email addresses, Slack channel references, or Microsoft Teams channel references).
      - `resource_id` string, required: The identifier of the widget containing the dataset.
      - `resource_type` 'widget_dataset_list', required: The type of resource targeted by a dataset report schedule.
      - `rrule` string, required: The recurrence rule for the schedule, expressed as an iCalendar `RRULE` string.
      - `status` 'active' | 'inactive', required: Whether the schedule is currently delivering reports (`active`) or paused (`inactive`).
      - `timeframe` string, required: The relative timeframe of data included in the report.
      - `timezone` string, required: The IANA time zone identifier the recurrence rule is evaluated in.
      - `title` string, required: The title of the report.
    - `id` string, uuid, required: The unique identifier of the dataset report schedule.
    - `relationships` ReportScheduleResponseRelationships, required: Relationships for the report schedule.
      - `author` ReportScheduleAuthorRelationship, required: Relationship to the author of the report schedule.
        - `data` ReportScheduleAuthorRelationshipData, required: Relationship data for the author of the report schedule.
          - `id` string, required: The user UUID of the report schedule author.
          - `type` 'users', required: JSON:API resource type for the included report author.
    - `type` 'schedule', required: JSON:API resource type for report schedules.
  - `included` ReportScheduleIncludedResource[]: Related resources included with the report schedules, such as authors.
    - union: A related resource included with a report schedule.
      - ReportScheduleAuthor: A user included as a related JSON:API resource.
        - `attributes` ReportScheduleAuthorAttributes, required: Attributes of the report author.
          - `email` string, nullable, required: The email address of the report author, or `null` if unavailable.
          - `name` string, nullable, required: The display name of the report author, or `null` if unavailable.
        - `id` string, required: The user UUID.
        - `type` 'users', required: JSON:API resource type for the included report author.
      - ReportScheduleResource: A report target resource included as a related JSON:API resource.
        - `attributes` ReportScheduleResourceAttributes, required: Attributes of an included report target resource.
          - `resource_type` 'dashboard' | 'integration_dashboard', required: The type of dashboard resource the report schedule targets.
          - `template_variables` ReportScheduleIndexTemplateVariable[], nullable: Template variable metadata from the dashboard resource, when available.
            - `available_values` string[], nullable: Available values for the template variable.
            - `defaults` string[], nullable: Default values for the template variable.
            - `name` string, nullable: The template variable name.
            - `prefix` string, nullable: The tag prefix for the template variable, when available.
          - `title` string, nullable: The title of the dashboard or integration dashboard resource, when available.
        - `id` string, required: The resource identifier.
        - `type` 'resource', required: JSON:API resource type for an included report resource.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)