report_list

Fetch the reports members have filed on this server. Moderators use it to build a review queue. The server doesn’t push new reports, so poll this command to see them.

Request

{
  "cmd": "report_list",
  "status": "open"
}

Field	Type	Required	Description
`status`	string	No	Only return reports with this status: `open`, `resolved`, or `dismissed`. Leave it out to get every report.

Response

{
  "cmd": "report_list",
  "reports": [
    {
      "id": "5b1f3c1e-8d0a-4d6e-9f43-2a7c9e1b0d55",
      "reporter": "alice",
      "target_type": "user",
      "target_id": "usr_8f2k1",
      "reason": "Impersonating a moderator",
      "snapshot": { "username": "mallory" },
      "status": "open",
      "created_at": 1727180530.204,
      "resolved_by": null,
      "resolved_at": null
    }
  ]
}

reports is ordered newest first. There is no paging.
Each report has the fields described on report_create.
The server keeps only the newest 2000 reports. Older ones are dropped when a new report is saved or a report is resolved.
Reports forwarded to Rotur aren’t stored, so they never appear here.

Permissions

Requires review_reports.

Errors

`val`	When
`status: Expected one of [open resolved dismissed], received closed`	`status` isn’t one of the allowed values.
`Report storage is unavailable`	The report file can’t be read.

See also