---
title: "Fetch reports"
method: GET
path: "/reports"
tags: ["Reports"]
---

# Fetch reports

`GET /reports`

## Query parameters

- `ids` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- object[]
  - `id` integer, required — The ID of the report
  - `resource_type` 'Report', required — The resource type of the report
  - `name` string, required — The name of the report
  - `status` 'waiting' | 'in_progress' | 'finished' | 'failed', required — The status of the report.
  - `created_at` string, date-time, required — When the report was created
  - `updated_at` string, date-time, required — When the report was updated
  - `start_date` string, date, required — The start date of the interval used to filter the data for the report. This timestamp is expected to be in date format, YYYY-MM-DD. If provided, it defines the beginning of the reporting period. The interval cannot be shorter than the minimum and cannot be longer than the maximum, as defined by the reporter. Current minimum interval days: no limit Current maximum interval days: 180
  - `end_date` string, date, required — The end date of the interval used to filter the data for the report. This timestamp is expected to be in date format, YYYY-MM-DD. If provided, it defines the end of the reporting period. The interval cannot be shorter than the minimum and cannot be longer than the maximum, as defined by the reporter. Current minimum interval days: no limit Current maximum interval days: 180
  - `time_zone` string, time-zone, nullable, required — The time zone used for interpreting the start and end dates of the report. This should be provided as a valid time zone identifier (e.g., "America/New_York"). If not provided, it defaults to the organization's time zone.
  - `organization_id` integer, required — The organization ID of the report
  - `organization` object, required — The organization of the report
    - `id` integer, required — The ID of the organization
    - `resource_type` 'Organization', required — The resource type of the organization
    - `name` string, required — The name of the organization
    - `domain` string, required — The domain of the organization.
  - `place_id` integer, nullable, required — The place ID of the report
  - `reporter_id` integer, required — The reporter ID of the report

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/kisi/apis/kisi-api.md) · [All operations](https://skmtc.dev/kisi/apis/kisi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kisi/kisi-api/revisions/998700ffff5a/schema)