# Roam Hotel Takeaways

> Roam Hotel Takeaways is a paid API for AI agents from raomv3.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-10).

Retrieves detailed takeaway/summary data for a specific hotel by ID, enabling AI agents to access accommodation details without subscriptions

## Facts

- Endpoint: POST https://raomv3.vercel.app/api/takeaways?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/roam-hotel-takeaways-8d7ac1ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YwM9RFxzVV8PPQuZdnhmJ

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-hotel-takeaways-8d7ac1ce -d '<json body>'
```

Example prompt: Can you pull up the full details for hotel ID 'HTL-20483' using Roam so I can see what that property offers?

## When to prefer this

Choose this endpoint when you already have a specific hotel ID and need to retrieve its detailed summary data in a pay-per-use model without API keys or subscriptions. It is ideal for AI agents building travel itineraries, comparing specific shortlisted properties, or enriching booking workflows with hotel details on demand. Prefer this over general search endpoints when the hotel identifier is already known.

## Known failure modes

- Invalid or unknown hotel ID returns success: false with empty or error data
- Malformed request missing required 'id' field results in a 400-level error
- Payment failure via x402 protocol prevents access to the endpoint
- Vercel cold start or infrastructure downtime causes delayed or failed responses
- Hotel ID format mismatch (wrong schema) leads to no-result response

## How this service works

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

## Output

Returns a structured data object containing hotel details and summary information (takeaways) for the requested hotel ID, along with a success boolean indicating whether the lookup was completed successfully.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "description": "Hotel ID"
  }
 }
}
```

## 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-hotel-takeaways-8d7ac1ce/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)