{"uid":"cap_x0M54-qB9Tekogli7LzKW","slug":"roam-hotel-vacancy-check-bbd94f2a","name":"Roam Hotel Vacancy Check","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://raomv3.vercel.app/api/vacancy?utm_source=zero.xyz","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":"registry","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_6jH76AqZQdMg4uVG0ji0X","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 by ID for given check-in and check-out dates","exampleAgentPrompt":"Check if hotel H-2847 has any rooms available from June 14 to June 18 using Roam's vacancy API.","exampleUseCases":[{"title":"Last-minute hotel availability check","prompt":"Can you check if hotel ID HTLNYC-1042 has any vacancies this weekend — I'd be checking in Friday June 20 and checking out Sunday June 22?"},{"title":"Multi-hotel availability comparison","prompt":"I'm planning a trip to London from July 5 to July 10. Check hotel LONBRI-205 on Roam to see if they have rooms available for those dates."},{"title":"Pre-booking vacancy verification","prompt":"Before I commit to anything, can you verify that hotel ID AMSTEL-88 still has availability for check-in August 1 and check-out August 7?"}],"resultDescription":"Returns a JSON object with a success boolean and a data object containing vacancy details for the specified hotel and date range, such as available room types, quantities, or rate information.","failureModes":["Invalid or unknown hotel ID returns an error or empty data","Malformed date strings may cause request failure","Dates in the past or illogical date ranges (checkout before checkin) may return errors","Hotel may return no vacancies (fully booked) with success true but empty data","Network or server errors from the Vercel deployment may cause timeouts","Insufficient USDC balance for x402 payment causes payment failure before request is processed"],"whenToPreferThis":"Use this endpoint when you already have a specific hotel ID and need to verify room availability for defined travel dates before booking. It is ideal for AI agents orchestrating travel planning that need lightweight, pay-per-use hotel vacancy lookups without requiring API keys or subscriptions — just USDC via x402. Prefer this over broader hotel search APIs when you want a direct vacancy status check on a known property.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:33:20.064Z","isFirstParty":false,"canonicalSlug":"roam-hotel-vacancy-check-bbd94f2a"}