# Roam Accommodation Perks Search

> Roam Accommodation Perks Search is a paid API for AI agents from raomv3.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-09).

Search for accommodations by amenities/perks, returning matching lodging options for AI agents via pay-per-request USDC payment.

## Facts

- Endpoint: POST https://raomv3.vercel.app/api/perks?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/roam-accommodation-perks-search-f1096407
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4esfDxhqo5qp9xp5SgMSb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability roam-accommodation-perks-search-f1096407 -d '<json body>'
```

Example prompt: Search Roam for accommodations that have a pool, free wifi, and pet-friendly amenities — I need a place that checks all three boxes.

## When to prefer this

Choose this endpoint when an AI agent needs to find accommodations filtered by specific amenity requirements without requiring API keys or subscriptions. It is ideal for agentic workflows that need frictionless, pay-per-use lodging search paid in USDC via the x402 protocol. Prefer this over traditional hotel APIs when you want no auth overhead and micro-payment-based access.

## Known failure modes

- Missing required 'amenities' array returns a validation error
- Empty amenities array may return no results or an error
- Payment failure via x402 (insufficient USDC balance) blocks the request
- No matching accommodations found returns success:true with empty data
- Service unavailability on Vercel deployment may return 5xx errors

## How this service works

Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.

## Output

Returns a JSON object with a success boolean and a data object containing accommodation listings or perks data matching the requested amenities. Exact structure of the data object is not fully specified but reflects matching lodging options.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "amenities"
 ],
 "properties": {
  "amenities": {
   "type": "array",
   "description": "List of amenities to search for"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/roam-accommodation-perks-search-f1096407/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from raomv3.vercel.app](https://www.zero.xyz/host/raomv3.vercel.app/llms.txt)