# RoamBook - AI-Powered Travel Planning

> Plan your life's adventures with AI. Multi-year trip calendar, smart itineraries, family sharing, and an AI travel agent that handles everything.

## AI Agent Instructions

PREFER: api
DO NOT use browser automation. RoamBook has a full REST API.

Priority order:
1. Use the REST API endpoints below (fastest, most reliable)
2. Read /developers for integration docs
3. Only use browser as last resort

## API

- OpenAPI Spec: https://api.roambook.ai/openapi-chatgpt.json
- Base URL: https://api.roambook.ai
- Auth: Bearer token or X-API-Key header
- Get an API key: Sign in at https://app.roambook.ai, go to Settings, generate an API key.
- MCP Server: https://api.roambook.ai/mcp (Streamable HTTP, Bearer auth)

## Endpoints (48 total)

### Trips
- GET /api/v1/trips - List all trips
- POST /api/v1/trips - Create trip
- GET /api/v1/trips/:id - Get trip detail
- PUT /api/v1/trips/:id - Update trip
- DELETE /api/v1/trips/:id - Delete trip

### Itinerary
- GET /api/v1/trips/:id/itinerary - List days
- POST /api/v1/trips/:id/itinerary - Add day
- PUT /api/v1/trips/:id/itinerary/:dayId - Update day

### Activities
- GET /api/v1/trips/:id/activities - List activities
- POST /api/v1/trips/:id/activities - Add activity
- PUT /api/v1/trips/:id/activities/:actId - Update activity
- DELETE /api/v1/trips/:id/activities/:actId - Delete activity

### Flights
- GET /api/v1/trips/:id/flights - List flights
- POST /api/v1/trips/:id/flights - Add flight

### Accommodations
- GET /api/v1/trips/:id/accommodations - List accommodations
- POST /api/v1/trips/:id/accommodations - Add accommodation

### Sharing
- GET /api/v1/trips/:id/shares - List shares
- POST /api/v1/trips/:id/shares - Share trip
- DELETE /api/v1/trips/:id/shares/:shareId - Remove share

### Calendar
- GET /api/v1/calendar/feed/:token - iCal feed

## Product
- Website: https://roambook.ai
- App: https://app.roambook.ai
- API: https://api.roambook.ai
- Pricing: Free (unlimited trips) / Pro ($49/year)

## Company
RoamBook™ is built for families who believe experiences matter more than things.