{"openapi":"3.1.0","info":{"title":"aloja.casa guest public API","version":"1.0.0","description":"Unauthenticated read-only lodging catalog, availability, and stay quotes for this tenant. Same queries the guest booking site uses. Browsing LLMs: prefer these REST routes (and the guest site /llms.txt) over MCP; ChatGPT web does not auto-bind Streamable HTTP MCP. After quoting, send humans to booking deep-links on the guest site (see x-aloja-booking-deep-links). Private Ops MCP (/mcp) is not part of this document."},"servers":[{"url":"https://api.cimacalidez.com"}],"paths":{"/properties/home-showcase":{"get":{"operationId":"listHomeShowcase","summary":"Public property catalog cards","security":[],"responses":{"200":{"description":"Home showcase property list"}}}},"/properties/multiple":{"get":{"operationId":"getMultipleProperties","summary":"Public properties by UUID list","security":[],"parameters":[{"name":"propertiesIds","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"Property details"}}}},"/properties/names-and-images-urls":{"get":{"operationId":"getPropertyNamesAndImages","summary":"Public names and image URLs by UUID list","security":[],"parameters":[{"name":"propertiesIds","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"Names and image URLs"}}}},"/properties/{identifier}":{"get":{"operationId":"getProperty","summary":"Public property by UUID or slug","security":[],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Property detail"}}}},"/availability/booking-options":{"get":{"operationId":"getBookingOptions","summary":"Stay quote / booking options with pricing","security":[],"parameters":[{"name":"checkInDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"checkOutDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"adultsQuantity","in":"query","required":true,"schema":{"type":"string"}},{"name":"teenagersQuantity","in":"query","required":false,"schema":{"type":"string"}},{"name":"childrenQuantity","in":"query","required":false,"schema":{"type":"string"}},{"name":"babiesQuantity","in":"query","required":false,"schema":{"type":"string"}},{"name":"petsQuantity","in":"query","required":false,"schema":{"type":"string"}},{"name":"propertiesIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"Booking options with pricing snapshot. After quoting, build a human reserve CTA on the guest site: /search/options with the same date/guest query names (see x-aloja-booking-deep-links)."}}}},"/availability/property-calendar":{"get":{"operationId":"getPropertyCalendar","summary":"Booked/blocked calendar for one property","security":[],"parameters":[{"name":"propertyId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Date-keyed calendar cells"}}}},"/availability/search-restrictions":{"get":{"operationId":"getSearchRestrictions","summary":"Aggregated search restriction thresholds","security":[],"parameters":[{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Per-date restriction thresholds"}}}}},"x-aloja-guest-mcp":{"serverName":"aloja-guest-mcp","path":"/guest-mcp","authentication":"none","methods":{"POST":"Streamable HTTP MCP JSON-RPC (tools mirror these REST paths)","GET":"Discovery tip only — not a data endpoint; use this OpenAPI + REST"},"note":"When GUEST_MCP_ENABLED=true, Streamable HTTP MCP exposes the same reads as tools. Browsing agents should prefer REST. Private Ops MCP at /mcp is intentionally omitted."},"x-aloja-booking-deep-links":{"description":"Human booking CTAs live on the tenant guest site (not on this API host). Resolve the guest origin from the brand website that linked here (or from guest /.well-known/mcp.json /llms.txt).","searchOptions":{"path":"/search/options","template":"{guestSiteOrigin}/search/options?checkInDate=YYYY-MM-DD&checkOutDate=YYYY-MM-DD&adultsQuantity=N","queryNames":["checkInDate","checkOutDate","adultsQuantity","teenagersQuantity","childrenQuantity","babiesQuantity","petsQuantity"],"note":"Query names match GET /availability/booking-options. Do not invent checkout hold URLs."},"propertyPage":{"path":"/properties/{slug-or-uuid}","template":"{guestSiteOrigin}/properties/{slug-or-uuid}","note":"Property browse page; calendar CTA continues on the guest site."},"guestDiscovery":{"llmsTxt":"{guestSiteOrigin}/llms.txt","wellKnownLlmsTxt":"{guestSiteOrigin}/.well-known/llms.txt","wellKnownMcp":"{guestSiteOrigin}/.well-known/mcp.json"}}}