Skip to content
KismetKismetDevelopers
llms.txt

List the signed-in guest saved vacation rentals

View .md

GET /v1/developer/guest/me/saves

Operation ID: listDeveloperGuestSaves

List the signed-in guest saved vacation rentals

Contract status

Section titled “Contract status”
Field Value
Maturity beta
Required capability guest_auth.write
Freshness class authenticated-state
Quota cost 1

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

Section titled “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

Section titled “Request body”

This operation has no JSON request body.

cURL

Section titled “cURL”

Set KISMET_API_ORIGIN=https://api.ksmt.app and configure KISMET_DEVELOPER_API_KEY in your environment. Run server-credential requests from your backend, not browser code.

Guest access tokens come from the signed-in guest session held by your backend. Forward a CSRF proof only after your same-origin backend validates it. If shown, KISMET_SITE_ORIGIN is the authorized origin of your site. Do not substitute a guest ID or an invented token.

Terminal window
curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/guest/me/saves" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json" \
  --header "x-kismet-guest-token: $GUEST_ACCESS_TOKEN"

Responses

Section titled “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.

200 response example

Section titled “200 response example”
{
  "data": [],
  "page": {
    "limit": 20,
    "nextCursor": null
  }
}

200 response schema

Section titled “200 response schema”

Content type: application/json. Required fields, nullable values, and nested structures are defined below.

View complete response schema 
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "page"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "savedAt",
          "checkIn",
          "checkOut",
          "vacationRental"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "savedAt": {
            "type": "string",
            "format": "date-time"
          },
          "checkIn": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "checkOut": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "quote": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": false,
            "required": [
              "totalMinor",
              "currency",
              "quotedAt",
              "expiresAt"
            ],
            "properties": {
              "totalMinor": {
                "type": "integer"
              },
              "currency": {
                "type": "string"
              },
              "quotedAt": {
                "type": "string",
                "format": "date-time"
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "vacationRental": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "slug",
              "name"
            ],
            "properties": {
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "imageUrl": {
                "type": [
                  "null",
                  "string"
                ]
              }
            }
          }
        }
      }
    },
    "page": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "limit",
        "nextCursor"
      ],
      "properties": {
        "limit": {
          "type": "integer"
        },
        "nextCursor": {
          "type": [
            "null",
            "string"
          ]
        }
      }
    }
  }
}

Machine-readable sources

Section titled “Machine-readable sources”