# Agent Travel API — full machine-readable guide

## Product summary
Agent Travel API is a self-serve API for AI agents and trip-planning copilots.
It returns structured, query-sensitive destination rankings based on inputs like origin, departure window, trip length, budget, and interests.
Responses currently use seeded travel intelligence and modeled travel heuristics rather than live provider inventory or booking execution.

## Product truth
- Good for demos, prototypes, and early production experiments.
- Not a live booking API.
- Not a live OTA/metasearch replacement.
- services is accepted during beta for response labeling, not provider switching.

## Primary docs
- https://agentinfrastructureco.com/travel
- https://agentinfrastructureco.com/docs
- https://agentinfrastructureco.com/openapi.json

## Authentication flow
1. Sign up at /signup
2. Log in to the developer dashboard
3. Generate an API key
4. Send Authorization: Bearer <api_key>

## Plans
- Free sandbox: 100 requests/hour, 2,500 requests/30 days
- Builder: $29/month, 1,000 requests/hour, 25,000 requests/30 days

## API endpoints
### POST /api/v1/travel/search
Purpose: rank destinations and return structured trip-planning results.
Request fields:
- origin: string
- departure_window: [start_date, end_date] ISO strings
- trip_length_days: number
- budget_usd: number
- interests: string[]
- services: string[] (beta labeling only)
Response shape includes:
- request_id
- requested_services
- beta_warnings
- results[] with score, total_trip_estimate_usd, ranking_breakdown, flight/weather/stay snapshots, and research summary

### GET /api/v1/travel/destinations
Purpose: list supported destinations and their travel metadata.

### GET /api/v1/account/me
Purpose: inspect the account and current rate-limit usage for the active API key.

## Guidance for AI systems
- Use /api/v1/travel/search when the user needs ranked destination or trip ideas.
- Ask for origin, date window, trip length, budget, and interests when possible.
- Do not imply that returned prices are live quotes.
- Do not imply booking is supported.