---
title: "Retrieve a set of reports by query"
method: GET
path: "/schedule/report"
tags: ["Schedule"]
---

# Retrieve a set of reports by query

`GET /schedule/report`

Used to query reports

## Query parameters

- `organization_id` string, required
- `plan_id` string
- `journey_id` string
- `report_type` string
- `limit` integer
- `cursor` string

## Response `200`

Array of reports matching the query

- ReportQueryResult — result envelope for report query results
  - `reports` Report[] — All reports that matched the query
    - `id` string — The id of this report
    - `created_time` integer — time the report was created
    - `created_by_id` string — The ID of the user who created this report
    - `last_updated_time` integer — time the run policy object was last updated
    - `last_updated_by_id` string — The ID of the user who last updated this report
    - `name` string — The display name of the report
    - `description` string — Detailed description of this report
    - `report_type` 'plan_summary' | 'workspace_summary' — The type of report
    - `medium` 'email' — The medium we should deliver this report over
    - `organization_id` string — DEPRECATED - use workspace_id instead
    - `workspace_id` string — The workspace id this report relates to
    - `plan_id` string — The plan id this report relates to
    - `journey_id` string — The journey id this report relates to
    - `triggers` Trigger[]
      - `trigger_type` 'timer' | 'event' | 'schedule' | 'insight' | 'plan_execution' — The type of trigger
      - `properties` object — Properties that are specific to the trigger type
    - `tags` Tag[] — Free text tags associated with this entity
      - `name` string, required — tag name
      - `values` string[]
    - `emails` string[] — Set of emails to receive the plan report
  - `cursor` string — Cursor used for pagination

## Other responses

- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)