# 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

### User & Profile
- GET /api/v1/me - Get current user profile
- PUT /api/v1/me - Update profile
- POST /api/v1/me/api-keys - Generate API key
- DELETE /api/v1/me/api-keys/:keyId - Revoke API key

### Packing Lists
- GET /api/v1/trips/:id/packing - List packing items
- POST /api/v1/trips/:id/packing - Add packing item
- PUT /api/v1/trips/:id/packing/:itemId - Update item (check/uncheck)
- DELETE /api/v1/trips/:id/packing/:itemId - Remove item

### Budget & Expenses
- GET /api/v1/trips/:id/budget - Get budget summary
- POST /api/v1/trips/:id/budget/expenses - Add expense
- PUT /api/v1/trips/:id/budget/expenses/:expId - Update expense
- DELETE /api/v1/trips/:id/budget/expenses/:expId - Delete expense

### Notes
- GET /api/v1/trips/:id/notes - List trip notes
- POST /api/v1/trips/:id/notes - Add note
- DELETE /api/v1/trips/:id/notes/:noteId - Delete note

### Documents
- GET /api/v1/trips/:id/documents - List documents (passports, bookings, visas)
- POST /api/v1/trips/:id/documents - Attach document
- DELETE /api/v1/trips/:id/documents/:docId - Remove document

### AI Assistant
- POST /api/v1/ai/chat - Chat with RoamBook AI travel agent
- POST /api/v1/trips/:id/ai/suggest - Get AI suggestions for a trip
- POST /api/v1/trips/:id/ai/optimize - Optimize trip itinerary with AI

### Search
- GET /api/v1/search/destinations - Search destinations
- GET /api/v1/search/places - Search places and points of interest

### Notifications
- GET /api/v1/notifications - List notifications
- PUT /api/v1/notifications/:id/read - Mark notification as read

### Bucket List
- GET /api/v1/bucket-list - List bucket list destinations
- POST /api/v1/bucket-list - Add destination to bucket list
- DELETE /api/v1/bucket-list/:id - Remove from bucket list

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

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