Vacation Rental Protocol

VRP Terms Vocabulary

This page defines the VRP namespace used by https://vacationrentalprotocol.com/contexts/v1. Term IRIs use the form https://vacationrentalprotocol.com/terms#TermName.

VRP is an open protocol for host-domain signed vacation rental offers and privacy-minimized portable attestations. This vocabulary does not create a central issuer, registry, scorer, marketplace, OTA, booking intermediary, accreditation program, or trust authority.

Category

VRPVacationRental — “VRP vacation rental”
A holiday home whose host runs its own booking site on its own domain and publishes stay offers signed by that domain under VRP, so any guest or AI agent can verify the price, dates and conditions over plain HTTPS. What is a VRP vacation rental?

Credential Types

VRPHostDomainCredential
A Verifiable Credential type for host-domain VRP node facts.
VRPPaymentPathCredential
A Verifiable Credential type for privacy-minimized payment path facts.
VRPPolicySnapshotCredential
A Verifiable Credential type for host-domain policy snapshot facts.
VRPVerifiedStayCredential
An optional Verifiable Credential type for a privacy-minimized stay reference linked to a verified VRP offer.
VRPPropertyAttestedClaimsCredential
A Verifiable Credential type carrying a host-attested, tri-state manifest of per-property claims (amenities and policies), each affirmed or negated. An absent claim is Unknown.
VRPRegulatoryRegistrationCredential
A Verifiable Credential type carrying the node's short-term-rental registration identifier for its jurisdiction, with an explicit evidence level (self_declared, registry_verified, or the reserved state_attested). The signature proves the node published exactly this claim; it never upgrades the evidence.

Credential Subject Types

VRPHostDomain
Subject type for canonical domain, discovery, JWKS, and protocol facts.
VRPPaymentPath
Subject type for host-controlled checkout and payment routing facts.
VRPPolicySnapshot
Subject type for a referenced, hashed, versioned policy artifact.
VRPVerifiedStay
Subject type for a non-identifying verified stay reference.
VRPPropertyClaimsManifest
Subject type for a tri-state manifest of per-property attested claims.
VRPRegulatoryRegistration
Subject type for a jurisdiction-neutral regulatory registration claim at an explicit evidence level.
VRPStatusListEntry
Credential status entry type for VRP v0.1 revocation or suspension references.
VRPStatusList
Simple VRP status list document type for v0.1 status entries.

Properties

canonicalDomain
The host-domain identity used by the VRP node and issuer DID.
vrpDiscoveryUrl
HTTPS URL for the host-domain VRP discovery document.
jwksUrl
HTTPS URL for the host-domain JSON Web Key Set.
protocol
Protocol identifier, for example vacation-rental-protocol.
protocolVersion
Protocol version asserted by the subject.
domainControlAttested
Boolean assertion that the issuer controls the canonical host-domain node facts.
registrationId
The short-term-rental registration identifier as issued under the jurisdiction's scheme.
authority
The registering authority for a regulatory registration, as declared.
jurisdiction
The property's jurisdiction (country name or code) for a regulatory registration claim. Declarative and jurisdiction-neutral.
evidence
Evidence level of a regulatory registration claim: self_declared, registry_verified, or the reserved state_attested.
verifiedAt
When a registry_verified registration claim was checked against the jurisdiction's register.
disclaimer
Required plain-language caveat on a self_declared registration claim: it is not independently verified.
paymentProcessor
Payment processor used by the host-domain payment path.
checkoutDomain
Domain used for checkout handoff or payment completion.
directBookingDomain
Domain that owns the direct booking flow.
merchantOfRecord
Entity responsible as merchant of record for the payment path.
paymentFactsSource
Source system for payment routing facts.
policyRef
Opaque reference for the policy artifact.
policyUrl
HTTPS URL for the policy artifact or canonical policy page.
policyHash
Hash reference for the canonicalized policy artifact.
policyVersion
Version label for the policy snapshot.
appliesTo
Object describing the non-guest-identifying scope of a policy snapshot.
propertyRef
Non-guest-identifying property reference.
stayRef
Opaque, non-reversible stay reference.
verifiedOfferHash
Hash of the exact compact JWS for the verified offer linked to the stay reference.
coarseStayPeriod
Optional coarse period such as a month or season, omitted when it could identify a guest.
claims
Array of tri-state attested claims in a property claims manifest. Each claim key MUST be unique within the array.
claim
Opaque lowercase snake_case key (^[a-z][a-z0-9_]*$) naming the amenity or policy being asserted.
state
The host-attested state of a claim: affirmed or negated. Unknown is the absence of the claim, never a stored value.
verified_at
Optional ISO 8601 date on which the host last attested the claim. Omitted (never null) when the host has not attested it.
statusPurpose
Status purpose, such as revocation or suspension.
statusListUrl
HTTPS URL for the issuer-controlled VRP status list.
statusRef
Opaque status entry reference unique within a status list.
status
Status value, for example valid, revoked, or suspended.
entries
Array of status list entries.
mediaType
Media type for a bundle entry, for example application/vc+jwt.
compactJws
Compact JWS envelope containing a signed credential.

Normative Documents