---
title: "List the signed-in guest saved vacation rentals"
description: "List the signed-in guest saved vacation rentals"
---

`GET /v1/developer/guest/me/saves`

**Operation ID:** `listDeveloperGuestSaves`

List the signed-in guest saved vacation rentals

## Contract status

| Field | Value |
| --- | --- |
| Maturity | `beta` |
| Required capability | `guest_auth.write` |
| Freshness class | `authenticated-state` |
| Quota cost | `1` |
| Operational owner | Identity + Developer Experience |

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential's installation grants; identifiers in the URL never grant access.

## Request parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | no |  |
| `limit` | query | integer | no |  |
| `x-kismet-guest-token` | header | string | yes | Server-only Kismet guest access token held by the same-origin BFF. Never expose it to browser JavaScript. |

## Request body

This operation has no JSON request body.

## cURL

```sh
curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/guest/me/saves" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Success. |
| 400 | Invalid request parameters or body. |
| 401 | Missing, invalid, expired, or inappropriate credential/session. |
| 403 | Credential lacks the required grant/capability, or an origin/CSRF check failed. |
| 404 | The authorized resource was not found. |
| 429 | Rate limit or quota exceeded; inspect response metadata before retrying. |
| 503 | A required Kismet dependency is temporarily unavailable. |

### Success example

```json
{
  "data": [],
  "page": {
    "limit": 20,
    "nextCursor": null
  }
}
```

## Machine-readable sources

- [This page as Markdown](/api/reference/list-developer-guest-saves.md)
- [Developer API OpenAPI v0.7.0](/openapi.json)
