---
title: "List user reports"
method: GET
path: "/v0/user-reports"
tags: ["User Reports"]
---

# List user reports

`GET /v0/user-reports`

List user reports

## Query parameters

- `limit` integer, nullable — The maximum number of message groups to return. If the value exceeds the maximum, then the maximum value will be used.
- `reported_at[gte]` string, date-time, nullable — Inclusive start datetime filter for time of report, in UTC using the ISO 8601 format (e.g., '2021-03-14T15:09:26Z'). Only reports at or after this time will be returned.
- `reported_at[lt]` string, date-time, nullable — Exclusive end datetime filter for time of report, in UTC using the ISO 8601 format (e.g., '2021-03-14T15:09:26Z'). Only reports before this time will be returned.

## Response `200`

OK

- HandlerTypesListUserReportsResponse
  - `count` integer — Count of user reports matching filters (up to limit)
  - `user_reports` HandlerTypesMessageReportWithCanonicalID[] — User reports matching request filters
    - `channel` string — Channel used to report the group
    - `reported_at` string, date-time — Time the group was reported
    - `reported_by_message_id` string, nullable — ID of the reporting message (the user forward)
    - `reported_message_canonical_id` string — Canonical ID of the message that was reported
    - `reporter` string — Email address of the user who reported the group

---

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