{"openapi":"3.1.0","info":{"title":"ShoreKey · Ocean City Direct Vacation Rentals & Coastal Concierge API","version":"1.2.0","summary":"Zero-credential public discovery, availability, itemized stay quote, corridor availability, and coastal spotlight API for ShoreKey (Ocean City, Maryland).","description":"Public reads and quotes are stateless and have zero side effects. Exact street addresses, lockbox/keypad codes, and arrival instructions are never returned in public discovery or quotes and unlock only after a booking is confirmed by the rental company, paid in full, and within the active arrival window.","contact":{"name":"ShoreKey · Quantum Atlas","url":"https://shorekeyocmd.com/"}},"servers":[{"url":"https://shorekeyocmd.com/shorekey/api/public","description":"ShoreKey Public REST & Agent Protocol API"}],"paths":{"/houses":{"get":{"operationId":"shorekey_list_houses","summary":"List published Ocean City vacation homes","parameters":[{"name":"check_in","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"check_out","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"guests","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"site","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published vacation homes matching the query.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object"}}}}}}}},"/houses/{id}":{"get":{"operationId":"shorekey_get_house","summary":"Get public details, seasonal rules, and cancellation policy for a listed home","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"site","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public property detail (street address and arrival instructions omitted).","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"House not found or not listed."}}}},"/houses/{id}/unavailable":{"get":{"operationId":"shorekey_get_unavailable_dates","summary":"Get unavailable YYYY-MM-DD nights for a listed home","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Sorted list of unavailable YYYY-MM-DD dates.","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}}}}},"/houses/{id}/quote":{"get":{"operationId":"shorekey_quote_stay","summary":"Compute an itemized stay quote and check seasonal rules without holding nights","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"check_in","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"check_out","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"guests","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Stay availability check, itemized quote in USD cents, cancellation policy, and suggested stays.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/corridor-availability":{"get":{"operationId":"shorekey_corridor_availability","summary":"Query Ocean City corridor availability by street number","parameters":[{"name":"street","in":"query","required":true,"schema":{"type":"integer","minimum":0,"maximum":146}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"nights","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":28}},{"name":"guests","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Sanitized corridor stay windows with direct booking links.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/spotlights/catalog":{"get":{"operationId":"shorekey_list_spotlights","summary":"List Ocean City Coastal Spotlights in A2A catalog format","responses":{"200":{"description":"A2A spotlight catalog envelope (atlas.a2a.shorekey_spotlights.v1).","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/spotlights/x402/catalog":{"get":{"operationId":"shorekey_merchant_services_catalog","summary":"List ShoreKey merchant & owner service packages and x402 Base USDC settlement terms","responses":{"200":{"description":"Official x402 v2 merchant service catalog (atlas.x402.shorekey_merchant_services.v1).","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/spotlights/{id}/x402-checkout":{"post":{"operationId":"shorekey_spotlight_x402_checkout","summary":"Quote (HTTP 402) or settle (HTTP 200) a $199 30-Day Coastal Spotlight package via x402 Base USDC","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verified Base Mainnet USDC settlement receipt and activated 30-day Spotlight entitlement.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 v2 PaymentRequired challenge with PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/discovery/highlights":{"get":{"operationId":"shorekey_destination_pulse","summary":"List curated Ocean City area highlights by zone","parameters":[{"name":"zone","in":"query","required":false,"schema":{"type":"string","enum":["boardwalk","midtown","north","west_oc","ocean_pines"]}}],"responses":{"200":{"description":"Curated area highlight media.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/specials":{"get":{"operationId":"shorekey_discover_unrented_specials","summary":"Discover unrented last-minute stay windows, trapped orphan gaps, and 11-language Switchboard outreach previews","parameters":[{"name":"site","in":"query","required":false,"schema":{"type":"string"}},{"name":"zone","in":"query","required":false,"schema":{"type":"string","enum":["boardwalk","midtown","north","west_oc","ocean_pines"]}},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["ocean","bay","west_oc","ocean_pines"]}},{"name":"guests","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"max_days_out","in":"query","required":false,"schema":{"type":"integer","minimum":3,"maximum":60}},{"name":"include_orphan_gaps","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Unrented specials and orphan-gap feed (atlas.shorekey.unrented_specials.v1).","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/specials/multilingual-package":{"get":{"operationId":"shorekey_package_multilingual_outreach","summary":"Package an unrented stay window into up to 11 Switchboard hospitality languages and voice broadcast job spec","parameters":[{"name":"house_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"check_in","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"check_out","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"guests","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"special_pct","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":35}},{"name":"languages","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Multilingual Switchboard outreach package (atlas.shorekey.multilingual_outreach.v1).","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp":{"post":{"operationId":"shorekey_mcp_jsonrpc","summary":"Streamable HTTP Model Context Protocol (MCP) JSON-RPC 2.0 endpoint","responses":{"200":{"description":"MCP JSON-RPC 2.0 response.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/a2a":{"post":{"operationId":"shorekey_a2a_jsonrpc","summary":"Agent-to-Agent (A2A) JSON-RPC 2.0 endpoint","responses":{"200":{"description":"A2A JSON-RPC 2.0 Task or AgentCard response.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}