{"uid":"cap_gYeHvFemSi9Nv9EgoCkLa","slug":"roam-vacancy-check-91ade22a","name":"Roam Vacancy Check","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://rao-m.vercel.app/api/vacancy","method":"POST","headers":{},"bodySchema":{"type":"object","required":["id","checkin","checkout"],"properties":{"id":{"type":"string","description":"Hotel ID"},"checkin":{"type":"string","description":"Check-in date"},"checkout":{"type":"string","description":"Check-out date"}}},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-3kcHmUVn3ujm_sKMoYTM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Check room availability and vacancy for a specific hotel by ID and date range, paid per-request in USDC via x402.","exampleAgentPrompt":"Can you check if hotel ID 'h_8821' on Roam has any rooms available for check-in June 20 and checkout June 23?","exampleUseCases":null,"resultDescription":"Returns a JSON object with a success boolean and a data object containing vacancy/availability information for the requested hotel and date range.","failureModes":["Invalid or unknown hotel ID returns error or empty data","Malformed date strings cause validation errors","Missing required fields (id, checkin, checkout) cause 400-level errors","Payment failure via x402 if insufficient USDC balance prevents request from being processed","Dates in the past or reversed check-in/checkout may return errors or no results"],"whenToPreferThis":"Use this endpoint when you already have a specific hotel ID and need to verify real-time room availability for a defined stay window. Ideal for AI agents that need pay-per-use, no-subscription accommodation lookup without setting up OAuth or API keys — just USDC micropayments via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:10.567Z","isFirstParty":false}