{"openapi":"3.1.0","info":{"title":"OpenRoam mesh sandbox","version":"0.2.0","description":"Read-only public search; bearer-protected shared operator demo. No real payments, tenant identity isolation, global consensus or production scale guarantees."},"servers":[{"url":"/"}],"paths":{"/api/network":{"get":{"operationId":"network","description":"Configured authorities, indexed cursors and digests, freshness, hosted subscription status.","parameters":[],"security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/search":{"get":{"operationId":"search","description":"Exhaustive scan of indexed admitted properties for the supported pricing model. Fixed dates return eligible room/rate options; flexible dates return the cheapest stay per room/rate in the window. Pagination is not a stable snapshot. complete refers to configured feed coverage, never guaranteed live inventory.","parameters":[{"in":"query","name":"text","schema":{"type":"string"}},{"in":"query","name":"region","schema":{"type":"string"}},{"in":"query","name":"start","schema":{"type":"string","format":"date"}},{"in":"query","name":"end","schema":{"type":"string","format":"date"}},{"in":"query","name":"flex","schema":{"type":"boolean"}},{"in":"query","name":"beach","schema":{"type":"boolean"}},{"in":"query","name":"refundable","schema":{"type":"boolean"}},{"in":"query","name":"breakfast","schema":{"type":"boolean"}},{"in":"query","name":"adults","schema":{"type":"integer"}},{"in":"query","name":"minNights","schema":{"type":"integer"}},{"in":"query","name":"maxNights","schema":{"type":"integer"}},{"in":"query","name":"offset","schema":{"type":"integer"}},{"in":"query","name":"limit","schema":{"type":"integer"}}],"security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Search"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/quotes":{"post":{"operationId":"quote","description":"Live authoritative quote, expiring after 5 minutes. One room, 1–4 adults. No holds. All taxes included in synthetic prices.","parameters":[],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/bookings":{"post":{"operationId":"book","description":"Commit at the sole inventory authority. Persist node ID, quote ID and key before sending. Retry ambiguous outcomes with the same key even after expiry. No actual payment.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}}],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Reservation"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cancel":{"post":{"operationId":"cancel","description":"Idempotent cancellation; refundable products before UTC arrival day only.","parameters":[],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Reservation"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/inventory":{"post":{"operationId":"updateInventory","description":"Optimistic revision-checked update at the property authority. Count means remaining sellable inventory, not capacity.","parameters":[],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/hosted/properties":{"post":{"operationId":"provisionHostedProperty","description":"Operator-assisted demo provision with a seeded 365-day calendar. No customer identity or billing created.","parameters":[],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cases":{"post":{"operationId":"openCase","description":"Open a support case at the reservation authority.","parameters":[],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/care/resolve":{"post":{"operationId":"resolveCase","description":"Simulated goodwill refund under a cumulative €100 per-booking limit.","parameters":[],"security":[{"operator":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveInput"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/workspace":{"get":{"operationId":"workspace","description":"Shared operator-only demo reservations/cases. Includes per-node failures for reconciliation.","parameters":[],"security":[{"operator":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/properties":{"get":{"operationId":"properties","description":"Operator-only indexed product calendars.","parameters":[],"security":[{"operator":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object"}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/sync":{"post":{"operationId":"sync","description":"Attempt immediate feed synchronization; inspect individual source status.","parameters":[],"security":[{"operator":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object"}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable. For uncertain commits, retry the same quote and idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"QuoteInput":{"type":"object","properties":{"node":{"type":"string"},"propertyId":{"type":"string"},"roomId":{"type":"string"},"rateId":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"adults":{"type":"integer","minimum":1,"maximum":4}},"required":["node","propertyId","roomId","rateId","start","end","adults"]},"BookingInput":{"type":"object","properties":{"node":{"type":"string"},"quoteId":{"type":"string"}},"required":["node","quoteId"]},"CancelInput":{"type":"object","properties":{"node":{"type":"string"},"id":{"type":"string"}},"required":["node","id"]},"InventoryInput":{"type":"object","properties":{"node":{"type":"string"},"propertyId":{"type":"string"},"roomId":{"type":"string"},"date":{"type":"string","format":"date"},"revision":{"type":"integer"},"count":{"type":"integer","minimum":0,"maximum":1000},"price":{"type":"integer","minimum":1,"description":"EUR cents per night"}},"required":["node","propertyId","roomId","date","revision","count","price"]},"PropertyInput":{"type":"object","properties":{"node":{"type":"string"},"name":{"type":"string","maxLength":100},"location":{"type":"string","maxLength":100},"region":{"type":"string","enum":["africa","europe"]},"beach":{"type":"boolean"}},"required":["node","name","location","region","beach"]},"CaseInput":{"type":"object","properties":{"node":{"type":"string"},"reservationId":{"type":"string"},"message":{"type":"string","maxLength":2000}},"required":["node","reservationId","message"]},"ResolveInput":{"type":"object","properties":{"node":{"type":"string"},"id":{"type":"string"},"amount":{"type":"integer","minimum":1,"maximum":10000,"description":"EUR cents; cumulative per-reservation limit enforced"}},"required":["node","id","amount"]},"Offer":{"type":"object","properties":{"node":{"type":"string"},"propertyId":{"type":"string"},"roomId":{"type":"string"},"roomName":{"type":"string"},"rateId":{"type":"string"},"rateName":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"nights":{"type":"integer"},"adults":{"type":"integer"},"total":{"type":"integer"},"currency":{"type":"string","const":"EUR"},"refundable":{"type":"boolean"},"breakfast":{"type":"boolean"},"policy":{"type":"string"},"revision":{"type":"integer"}},"required":["node","propertyId","roomId","roomName","rateId","rateName","start","end","nights","adults","total","currency","refundable","breakfast","policy","revision"]},"Quote":{"allOf":[{"$ref":"#/components/schemas/Offer"},{"type":"object","properties":{"id":{"type":"string"},"expiresAt":{"type":"integer","description":"Unix milliseconds"},"taxesIncluded":{"type":"boolean"},"occupancy":{"type":"string"},"payment":{"type":"string"},"serviceOperator":{"type":"string"}},"required":["id","expiresAt","taxesIncluded","occupancy","payment","serviceOperator"]}]},"Reservation":{"allOf":[{"$ref":"#/components/schemas/Quote"},{"type":"object","properties":{"quoteId":{"type":"string"},"status":{"type":"string","enum":["confirmed","cancelled"]},"refunded":{"type":"integer"},"createdAt":{"type":"string"}},"required":["quoteId","status","refunded","createdAt"]}]},"Search":{"type":"object","properties":{"query":{"type":"object"},"total":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"node":{"type":"string"},"name":{"type":"string"},"location":{"type":"string"},"region":{"type":"string"},"beach":{"type":"boolean"},"revision":{"type":"integer"},"options":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"cheapest":{"$ref":"#/components/schemas/Offer"},"indexedAt":{"type":"string"},"stale":{"type":"boolean"}},"required":["id","node","name","location","region","beach","revision","options","cheapest","indexedAt","stale"]}},"offset":{"type":"integer"},"limit":{"type":"integer"},"elapsedMs":{"type":"number"},"evaluatedProperties":{"type":"integer"},"coverage":{"type":"array","items":{"type":"object"}},"complete":{"type":"boolean"},"semantics":{"type":"string"},"notice":{"type":"string"}},"required":["query","total","results","offset","limit","elapsedMs","evaluatedProperties","coverage","complete","semantics","notice"]}},"securitySchemes":{"operator":{"type":"http","scheme":"bearer"}}}}