{"uid":"cap_cczdBtM_-0I_j_JwAWsML","slug":"roam-hotel-vacancy-check-a5fbb10a","name":"Roam Hotel Vacancy Check","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://402stay.orbonomy.xyz/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_9-V9DkOxvzhTmTbeDiTb5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks room availability and vacancy for a specific hotel given check-in and check-out dates, paid per-request via x402 USDC micropayment.","exampleAgentPrompt":"Can you check if hotel ID 'HTL-98234' has any rooms available from June 14th to June 18th using Roam?","exampleUseCases":[{"title":"Verify hotel availability before booking","prompt":"Before I commit to this trip, can you check if the Marriott Downtown has rooms open for March 22nd through March 25th?"},{"title":"Find openings across multiple properties","prompt":"I'm flexible on which hotel to pick — can you check vacancy at these three properties for my July 10-15 trip and let me know which ones have availability?"},{"title":"Confirm last-minute accommodation options","prompt":"My flight just got rescheduled to tomorrow. Can you quickly check if the Holiday Inn near the airport has any rooms available for the next two nights?"}],"resultDescription":"Returns a JSON object with a success boolean and a data object containing vacancy/availability details for the queried hotel and date range.","failureModes":["Missing required field (id, checkin, or checkout) returns a validation error","Invalid hotel ID returns no results or error in data payload","Payment failure via x402 results in 402 Payment Required before data is returned","Malformed date strings may cause parsing errors","Hotel not found in database returns empty or null data"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically check hotel room availability for a specific property and date range without requiring API keys or subscriptions — ideal for pay-per-use agent workflows that pay in USDC via x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:35:08.562Z","isFirstParty":false}