{"uid":"cap_j255qhOIv3y2yaBxxeng6","slug":"roam-accommodation-perks-search-4877f3d6","name":"Roam Accommodation Perks Search","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://402roam.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_7_Fb31XilhfmVv03t0GWe","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 by amenities/perks, returning matching lodging options for AI agents via pay-per-request x402 payments.","exampleAgentPrompt":"Can you search Roam for accommodations that have a rooftop pool, free breakfast, and pet-friendly amenities?","exampleUseCases":null,"resultDescription":"Returns a JSON object with a success boolean and a data object containing accommodation results matching the requested amenities list.","failureModes":["Missing required amenities field returns validation error","Empty amenities array may return no results","Payment failure via x402 prevents request from being processed","Unknown or unrecognized amenity strings may yield empty results","Service unavailability returns HTTP error response"],"whenToPreferThis":"Use this endpoint when you need to filter or discover accommodations by specific amenities or perks in a pay-per-use model with no subscription required. Ideal for AI agents that need frictionless lodging search without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:31:34.200Z","isFirstParty":false}