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`
Operational owner	API + 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
`vacationRental`	path	string	yes

Request body

This operation has no JSON request body.

cURL

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.

Success 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"
    }
  ]
}

Machine-readable sources