List effective policies for a vacation rental

GET /v1/developer/vacation-rentals/{vacationRental}/policies

Operation ID: listVacationRentalPolicies

Returns published, non-transactional Kismet content within the authenticated application grant. No rates, availability, indicative pricing, booking URL, draft state, or vendor payload is returned.

Contract status

Field	Value
Maturity	`beta`
Required capability	`policies.read`
Freshness class	`published-content`
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

Name	In	Type	Required	Description
`vacationRental`	path	string	yes

Request body

This operation has no JSON request body.

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.

curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/vacation-rentals/sand-sea-110/policies" \
  --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.
429	Rate limit or quota exceeded; inspect response metadata before retrying.
503	A required Kismet dependency is temporarily unavailable.

200 response example

{
  "data": [
    {
      "policyType": "PET",
      "scope": "VR",
      "policyId": "55555555-5555-4555-8555-555555555555",
      "version": 2,
      "contentHash": "c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00",
      "effectiveAt": "2026-04-01T00:00:00.000Z",
      "title": "Pet policy",
      "url": "https://sandbox-stays.example/policies/pet",
      "format": "html",
      "body": "<p>Up to two dogs under 40 lb are welcome for a <strong>$75</strong> fee per stay.</p>"
    }
  ]
}

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"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "policyType",
          "scope",
          "title",
          "url"
        ],
        "properties": {
          "policyType": {
            "type": "string"
          },
          "scope": {
            "type": "string",
            "enum": [
              "VR",
              "VRM",
              "PMS"
            ]
          },
          "policyId": {
            "type": [
              "null",
              "string"
            ]
          },
          "version": {
            "type": [
              "null",
              "integer"
            ]
          },
          "contentHash": {
            "type": [
              "null",
              "string"
            ]
          },
          "effectiveAt": {
            "type": [
              "null",
              "string"
            ]
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "format": {
            "type": "string",
            "enum": [
              "html",
              "text"
            ]
          },
          "body": {
            "type": "string"
          }
        }
      }
    }
  }
}