v0.1 · Draft
base: https://demo.openstr.org

Protocol Endpoints

Interactive explorer for the OpenSTR reference implementation. Fire live requests against the demo property — a fictional two-bedroom flat in Lincoln Park, Chicago. See the full protocol spec →

demo.openstr.org · Listing ID: host-demo-chicago-001 · Currency: USD · Min stay: 2 nights
Discovery
GET /.well-known/openstr/:listing_id.json Property listing & metadata

Returns the full property listing: classification, capacity, amenities, pricing structure, policies, and endpoint references. No request body required.

Transactions
POST /openstr/availability Check dates & get pricing quote
Request parameters
POST /openstr/booking Submit booking request
Dates & guests
Guest details
Quote ID — run availability first to get a real quote_id, or use the demo value
Tip: run availability above then auto-fill quote_id from last response
Booking Management
v0.1 note: Booking amendments are not supported in this version. To change dates, guest count, or other details, cancel the existing booking and submit a new booking request. A dedicated amend endpoint covering zero-cost changes, top-up payments, and date repricing is planned for v0.2. See docs/DISCUSSION.md for design context.
GET /openstr/booking/:reference/status Retrieve booking status
Tip: make a booking above then auto-fill reference from last booking response
POST /openstr/booking/:reference/cancel Cancel a booking
Tip: make a booking above then auto-fill reference from last booking response