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

# GET /reports/

`GET /reports/`

## Request

- Base URL: `https://dados.gov.pt/api/1`
- URL: `https://dados.gov.pt/api/1/reports/`
- Auth: none declared

## Query parameters

- `page` integer
- `page_size` integer
- `sort` 'reported_at' | '-reported_at'
- `handled` boolean

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- ReportPage
  - `data` ReportRead[]: The page data
    - `by` UserReference
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `avatar` string: The user avatar URL
      - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version.
      - `first_name` string: The user first name
      - `last_name` string: The user larst name
      - `page` string: The user web page URL
      - `slug` string: The user permalink string
      - `uri` string: The API URI for this user
    - `callbacks` object
    - `dismissed_at` string, date-time
    - `dismissed_by` UserReference
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `avatar` string: The user avatar URL
      - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version.
      - `first_name` string: The user first name
      - `last_name` string: The user larst name
      - `page` string: The user web page URL
      - `slug` string: The user permalink string
      - `uri` string: The API URI for this user
    - `id` string, required
    - `message` string
    - `reason` 'auto_spam' | 'explicit_content' | 'illegal_content' | 'others' | 'personal_data' | 'security' | 'spam', required
    - `reported_at` string, date-time, required
    - `self_api_url` string: Link to the API endpoint for this report
    - `subject` LazyReference
      - `class` object
      - `id` object
    - `subject_deleted_at` string, date-time
    - `subject_embed_id` string: UUID of the embedded document within the subject (e.g., a Message within a Discussion)
  - `next_page` string: The next page URL if exists
  - `page` integer, required: The current page
  - `page_size` integer, required: The page size used for pagination
  - `previous_page` string: The previous page URL if exists
  - `total` integer, required: The total paginated items

## Changes

- **2026-09-11** `1175d034be00`: 2 info
  - added the new optional `query` request parameter `handled`
  - added the new optional `query` request parameter `sort`
- **2025-02-18** `8a6c4a5665e6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dados/apis/udata-api/changes/reports/get.md)

---

[API](https://skmtc.dev/dados/apis/udata-api.md) - [All operations](https://skmtc.dev/dados/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dados/apis/udata-api/revisions/77edaf8a00ea?raw)