{"uid":"cap_dsD6EhnMbfNGyuhqV9uxw","slug":"roam-vacancy-check-50d138c5","name":"Roam Vacancy Check","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://roam.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_sp0qecGwgCaCpTztZr9U_","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 a hotel ID and date range, paid per request via x402 USDC","exampleAgentPrompt":"Can you check if hotel ID 'HTL-394820' has any rooms available from June 14 to June 19?","exampleUseCases":[{"title":"Verify hotel availability before booking","prompt":"Before I book anything, can you check if hotel ID 'HTL-204751' has any rooms open from August 3rd to August 8th?"},{"title":"Check vacancy for business travel","prompt":"I need to stay near the conference venue — can you look up availability at hotel 'HTL-883102' for October 12 to October 15 so I know if it's worth pursuing?"},{"title":"Compare availability across trip dates","prompt":"We're flexible on dates — can you check hotel 'HTL-671439' for rooms from December 22 to December 27, and then again for December 26 to December 31, so we can see which works better?"}],"resultDescription":"A JSON object with a success boolean and a data object containing availability and vacancy details for the queried hotel and date range","failureModes":["Invalid or unknown hotel ID returns an error or empty data","Malformed date strings cause request rejection","Check-out date before check-in date results in an error","Payment failure via x402 prevents the request from completing","Hotel ID not found in the system returns a failed or empty response"],"whenToPreferThis":"Use this endpoint when you have a specific hotel ID and need to check real-time room availability for a given date range without needing to set up an API key or subscription — especially useful in agentic workflows where pay-per-use via USDC x402 is acceptable","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:40.388Z","isFirstParty":false}