{"openapi":"3.1.0","info":{"title":"GoForth Public Catalog","version":"1.0.0","description":"Read-only property search and comparison. All prices per 1/4 interest are in USD."},"servers":[{"url":"https://www.goforthglobal.com"}],"paths":{"/api/storefront":{"post":{"operationId":"queryCatalog","summary":"Read public GoForth homes and destinations","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["tool","input"],"additionalProperties":false,"description":"Search GoForth's published vacation homes by destination slug, minimum bedrooms, and maximum USD price per 1/4 interest. Returns current available/pending homes; onlyAvailable narrows to homes with interests for sale. Default limit 20, maximum 50. Results include canonical listing URLs.","properties":{"tool":{"type":"string","const":"search_homes"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"destinationSlug":{"type":"string","maxLength":160,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"minBedrooms":{"type":"integer","minimum":0,"maximum":100},"maxPricePerShare":{"type":"number","exclusiveMinimum":0},"onlyAvailable":{"type":"boolean"},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false}}},{"type":"object","required":["tool","input"],"additionalProperties":false,"description":"Read a GoForth property by its URL slug. Returns price per 1/4 interest in USD, total property value, bedrooms, amenities, availability, description and canonical URL. Does not reserve or purchase a home.","properties":{"tool":{"type":"string","const":"get_home"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":160,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["slug"],"additionalProperties":false}}},{"type":"object","required":["tool","input"],"additionalProperties":false,"description":"List GoForth's published destinations, including upcoming locations, their slugs and canonical URLs. Use a slug to filter search_homes.","properties":{"tool":{"type":"string","const":"list_destinations"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}},{"type":"object","required":["tool","input"],"additionalProperties":false,"description":"Compare 2 to 4 GoForth properties by slug. Returns their prices per 1/4 interest in USD, bedrooms, availability and descriptions side by side as structured data. Reports unavailable slugs explicitly.","properties":{"tool":{"type":"string","const":"compare_homes"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slugs":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","maxLength":160,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}},"required":["slugs"],"additionalProperties":false}}}]}}}},"responses":{"200":{"description":"Catalog result with canonical source URLs","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid tool or input"},"429":{"description":"Rate limited; retry after the Retry-After interval"},"503":{"description":"Content temporarily unavailable"}}}}}}