---
title: "Get list of reports"
method: GET
path: "/reports"
tags: ["Reports"]
---

# Get list of reports

`GET /reports`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Returns list of reports. Query parameters can be used to optimize the response.

## Query parameters

- `limit` integer: Max number of reports to return
- `offset` integer: Offset from the beginning of the reports list

## Response `200`

List of projects

- ReportList
  - `reports` ReportSchema[], required: List of reports
    - `resource_name` string, nullable: Name of the resource
    - `owner_workspace_id` integer, required: ID of the workspace that owns the report
    - `shared_lock_counter` integer, required: Counter for shared locks on the report
    - `exclusive_lock_flag` boolean, required: Flag indicating if the report is exclusively locked
    - `resource_id` integer, required: Unique identifier for the report resource
    - `parent_id` integer, nullable: ID of the parent resource, if applicable
    - `ordering` integer, required: Ordering index for the report
    - `resource_type` string, required: Type of the resource, e.g., 'report'
    - `owner_group_id` integer, nullable: ID of the group that owns the report, if applicable
    - `owner_user_id` integer, required: ID of the user who owns the report
    - `id` integer, required: Unique identifier for the report
    - `name` string, required: Name of the report
    - `sync_type` string, required: Synchronization type of the report, e.g., 'MANUAL'
    - `status` string, required: Current status of the report, e.g., 'ready'
    - `published_status` boolean, required: Indicates if the report is published
    - `users_emails` string[]: List of emails associated with users who can access this report
    - `message` string, nullable: Message to be sent when a report is shared with other users
    - `last_updated_at` string, required: Timestamp of the last update to the report
    - `created_at` string, required: Timestamp when the report was created
    - `last_synced_at` string, required: Timestamp of the last synchronization of the report
    - `owner_profile_link` string, nullable: Link to the profile of the user who created the report
    - `owner_name` string: Name of the user who created the report
  - `offset` integer
  - `limit` integer
  - `next` string, required: URI for next page of data

## Other responses

- `304`: Not Modified
- `400`: Bad Request
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)