From API to Booking: A Developer's Guide to Integrating VOLO's Agent API
If you are building an AI agent that handles travel, executive services, or luxury lifestyle management, integrating with VOLO gives your agent access to 500+ private aircraft worldwide — plus the ability to earn commissions on every booking. Here's how to get started.
Step 1: Register Your Agent
Registration takes one API call:
POST https://flyvolo.ai/api/v1/agent/register
Send a JSON body with your agent's name, contact email, and optional webhook URL. You will receive:
- A unique Agent ID (e.g.,
AGT-TRAVELBOT-2A3F) - An API key for authenticated requests
- A referral code for tracking attribution
- A referral URL for sharing
Step 2: Search for Flights
VOLO's search endpoint accepts natural language queries:
POST https://flyvolo.ai/api/v1/flights/search
Your agent can send queries like "Heavy jet, 8 passengers, New York to London, March 20" and receive structured JSON responses with aircraft options, specifications, pricing, and availability windows.
Step 3: Generate Quotes
Once your user selects an aircraft option, generate a detailed, all-inclusive quote. The response includes itemized costs (charter, fuel, landing fees, crew, catering) and a booking confirmation link.
Step 4: Track Referrals
Every booking made through your referral link or API key is automatically attributed to your agent. Monitor your performance through the dashboard endpoint:
GET https://flyvolo.ai/api/v1/agent/dashboard
The dashboard returns real-time metrics including total referrals, conversions, pending commissions, and historical earnings.
Integration Protocols
Choose the integration method that best fits your agent's architecture:
| Protocol | Best For | Features |
|---|---|---|
| REST API | General purpose | Standard HTTP, JSON responses, full feature set |
| GraphQL | Complex queries | Flexible data fetching, single endpoint, typed schema |
| OpenAI Plugin | ChatGPT/GPT agents | Natural language interface, automatic tool selection |
| MCP Server | Claude agents | Native Claude integration, stateless tools, local execution |
Commission Structure
As a registered agent partner, you earn commissions on every completed booking:
- Standard tier: 3.0% commission (0+ bookings)
- Silver tier: 3.5% commission (10+ bookings)
- Gold tier: 4.0% commission (50+ bookings)
- Platinum tier: 5.0% commission (200+ bookings)
On an average $50,000 booking, that translates to $1,500-$2,500 per successful referral. Commissions are settled monthly after flight completion.
Getting Help
Our developer documentation is available at flyvolo.ai/api/v1/openapi.json (OpenAPI 3.0 spec). For technical support, reach out to the engineering team. We are building the agent economy together.
The best agents will be those that can handle the full spectrum of their user's needs — from scheduling to booking to travel. VOLO's API makes private aviation one simple integration away.