{"uid":"cap_FZpdGfVGYJJq9RiiUn_wc","slug":"roam-accommodation-search-16f804a5","name":"Roam Accommodation Search","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://402stay.orbonomy.xyz/api/trip","method":"POST","headers":{},"bodySchema":{"type":"object","required":["destination"],"properties":{"days":{"type":"integer","description":"Number of days"},"destination":{"type":"string","description":"Destination city"}}},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N-uDBtgaJROkQYPHa0_Xd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for accommodation options in a destination city for a given number of days, payable per-request in USDC via x402.","exampleAgentPrompt":"Can you search Roam for places to stay in Barcelona for 5 days and show me the accommodation options?","exampleUseCases":null,"resultDescription":"A JSON object with a success boolean and a data object containing accommodation results for the requested destination and duration, such as hotel listings, properties, or stay options.","failureModes":["Missing required 'destination' field returns validation error","Payment failure via x402 protocol returns 402 Payment Required","Invalid or unrecognized destination city may return empty results or error","Network timeout from upstream accommodation data source","Malformed integer for 'days' field returns schema validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to search for accommodation in a specific city without requiring user authentication or subscription setup — ideal for zero-friction, pay-per-use travel research. Prefer this over traditional hotel APIs when you want no-auth access and per-request micropayment billing via x402/USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:21.790Z","isFirstParty":false}