# Rafid Intelligence Network — Hotel Search API

> Rafid Intelligence Network — Hotel Search API is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-30).

Searches for available hotels at a destination for given dates, guest count, and currency, returning live availability results.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/travel/hotel-search?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-intelligence-network-hotel-search-api-fd66a144
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XJWdTos8G6H60ri9lZWCO

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 rafid-intelligence-network-hotel-search-api-fd66a144 -d '<json body>'
```

Example prompt: Search for hotels in Dubai for 2 adults and 1 child aged 8, checking in on 2025-06-10 and checking out on 2025-06-15, show me up to 20 results priced in USD.

## When to prefer this

Use this endpoint when an AI agent needs live hotel availability and pricing for a specific destination and date range, especially within travel planning, itinerary building, or accommodation booking workflows. It is well-suited for agents that need structured hotel data with guest configuration (adults, children with ages) and currency localization. Prefer this over general web search when structured, machine-readable hotel results are required.

## Known failure modes

- Empty hotel array returned if no availability at destination for given dates
- Invalid date format (not YYYY-MM-DD) causes validation error
- Destination string too short or containing invalid characters rejected
- Child count and childAges array length mismatch may cause errors
- Upstream provider ('letsfg') outage returns provider status error
- Limit exceeds maximum of 50 causes schema validation failure
- Invalid currency code (not 3 uppercase letters) rejected
- Invalid nationality code (not 2 uppercase letters) rejected

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

Returns a JSON object containing a list of hotel results with count, destination query and resolved name, data mode (live), provider name and status, upstream latency in milliseconds, and the timestamp of the search. Hotel array may be empty if no availability is found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1
  },
  "adults": {
   "type": "integer",
   "default": 1,
   "maximum": 9,
   "minimum": 1
  },
  "checkIn": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
  },
  "checkOut": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
  },
  "children": {
   "type": "integer",
   "default": 0,
   "maximum": 8,
   "minimum": 0
  },
  "currency": {
   "type": "string",
   "default": "USD",
   "pattern": "^[A-Z]{3}$"
  },
  "childAges": {
   "type": "array",
   "items": {
    "type": "integer",
    "maximum": 17,
    "minimum": 0
   },
   "default": [],
   "maxItems": 8
  },
  "destination": {
   "type": "string",
   "pattern": "^[\\p{L}\\p{N} .,'()-]+$",
   "maxLength": 100,
   "minLength": 2
  },
  "nationality": {
   "type": "string",
   "pattern": "^[A-Z]{2}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 0,
  "hotels": [],
  "dataMode": "live",
  "provider": {
   "name": "letsfg",
   "status": "ok",
   "upstreamLatencyMs": 0
  },
  "searchedAt": "2026-10-04T00:00:00.000Z",
  "destination": {
   "query": "Dubai",
   "resolvedName": "Dubai"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-intelligence-network-hotel-search-api-fd66a144/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)