---
title: "List my in-app notifications"
method: GET
path: "/v1/notifications"
tags: ["notifications"]
---

# List my in-app notifications

`GET /v1/notifications`

## Request

- Base URL: `https://api.getmyhotels.com`
- URL: `https://api.getmyhotels.com/v1/notifications`
- Auth: HTTP bearer

Runs `notification.list`, newest first. `unreadOnly=true` limits it to unread ones. Returns `{ notifications, page, limit }`; each notification is `{ publicId, type, category, priority, title, body, data, actionUrl, imageUrl, readAt, createdAt, expiresAt }`. `type` includes `price_drop`, `rebook_alert` and `booking_auto_rebooked` among others — render unknown types with a generic icon. `data` is a JSON-encoded string or null; `actionUrl` is a site-relative or absolute link to open on tap.

## Query parameters

- `page` integer
- `limit` integer
- `unreadOnly` boolean

## Response `200`

Success

- unknown

## Other responses

- `400`: Request validation failed or the router rejected the input
- `401`: Missing or invalid bearer session token
- `426`: Reported X-GMH-App-Version is below the supported minimum — the app must update
- `500`: Unexpected server error (opaque; details stay in logs)

---

[API](https://skmtc.dev/getmyhotels/apis/getmyhotels-rest-api.md) · [All operations](https://skmtc.dev/getmyhotels/apis/getmyhotels-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getmyhotels/apis/getmyhotels-rest-api/revisions/cba24a9c13f0?raw)