---
title: "List my favorites"
method: GET
path: "/v1/favorites"
tags: ["favorites"]
---

# List my favorites

`GET /v1/favorites`

## Request

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

Runs `user.listFavorites` for one `entityType` (default `hotel`), newest first, one entry per hotel. Returns `{ entityIds, items }`: `items` are `{ entityType, entityId, hotelKey, ref, name, imageUrl, city, country, starRating }` where `entityId` equals `hotelKey` for a supplier hotel. `ref` is freshly minted on every response and opens `GET /v1/hotels/{ref}`; it is null when the row cannot mint one. The display fields are the snapshot the client sent when it saved the row, and are null for rows saved before snapshots existed (render a placeholder; never fail). Each item also has `savedAt`. `entityIds` lists the same entries' ids, in order.

## Query parameters

- `entityType` 'hotel' | 'flight' | 'car'

## 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)