{"uid":"cap_KLvaN2GQ0zH_Q7u6mCdqA","slug":"roam-accommodation-perks-search-81b0efb8","name":"Roam Accommodation Perks Search","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://402stay.orbonomy.xyz/api/perks","method":"POST","headers":{},"bodySchema":{"type":"object","required":["amenities"],"properties":{"amenities":{"type":"array","description":"List of amenities to search for"}}},"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_q4b2SqIF_A2uoPJc_Bvya","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":"Searches for accommodations matching a specified list of amenities/perks, payable per-request in USDC via x402","exampleAgentPrompt":"Search for accommodations on Roam that have a pool, gym, and free WiFi — I want to see what's available with those specific amenities.","exampleUseCases":[{"title":"Pet-friendly vacation rentals with kitchens","prompt":"Find me accommodations on Roam that allow pets and have a full kitchen — I'm taking my dog on a trip and need to cook some of our meals."},{"title":"Budget hotel stays with parking included","prompt":"I'm driving to the city and need a place to stay that has free parking and doesn't cost too much. Can you search Roam for hotels with those features?"},{"title":"Luxury stays with spa and concierge services","prompt":"Look up high-end accommodations on Roam that have an on-site spa and concierge service — I want to treat myself to a relaxing getaway."}],"resultDescription":"Returns a JSON object with a success boolean and a data object containing accommodation listings or perks results that match the requested amenities list.","failureModes":["Missing required 'amenities' array results in 400 validation error","Empty amenities array may return no results or error","Insufficient USDC balance causes x402 payment failure","Malformed amenity strings may return no matching results","Network timeout from upstream accommodation data provider"],"whenToPreferThis":"Use this endpoint when an AI agent needs to find accommodations filtered by specific amenities or perks, without requiring API keys or subscriptions — paying only per successful query in USDC via x402. Best suited for agents that need frictionless, one-off travel accommodation lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:37.849Z","isFirstParty":false}