---
title: "List all current user pending notifications"
method: GET
path: "/notifications/"
tags: ["notifications"]
---

# List all current user pending notifications

`GET /notifications/`

## Request

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

## Query parameters

- `page` integer
- `page_size` integer
- `sort` 'created' | 'last_modified' | 'handled_at' | '-created' | '-last_modified' | '-handled_at'
- `handled` boolean
- `user` string

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- NotificationPage
  - `data` NotificationRead[]: The page data
    - `created_at` string, date-time, required
    - `details` object
    - `handled_at` string, date-time
    - `id` string, required
    - `last_modified` string, date-time, required
    - `user` 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
  - `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`: 6 info
  - api operation id `get_notifications` removed and replaced with `list_notifications`
  - added the new optional `query` request parameter `handled`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `page_size`
  - …2 more

[Operation history](https://skmtc.dev/dados/apis/udata-api/changes/notifications/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)