Getting Started
Start integrating in minutes
The MustSeen Bridge Engine API transforms unstructured travel plans into validated, bookable itineraries. Whether you're building an AI travel planner or enhancing existing booking flows, our API provides the execution layer you need.
Get your API Key
Join our pilot program to receive your API credentials.
Choose your endpoint
Use /validate-only for AI validation or /ingest for full processing.
Send your first request
Follow the examples on the right to make your first API call.
Authentication
Secure your API requests
All API requests require authentication using a Bearer token in the Authorization header.
Authorization: Bearer YOUR_API_KEYPilot Program
API access is currently available through our pilot program. Apply here to get your credentials.
Base URL & Versioning
API endpoints and versions
All endpoints are versioned with /v1/ prefix. We maintain backwards compatibility within major versions.
AI Planner Validation
Validate AI-generated itineraries before showing to users
AI travel planners generate creative itineraries but often include impossible timings, hallucinated venues, or logistically infeasible connections. Use our validation endpoint as a quality gate before presenting plans to users.
Recommended Endpoint:
Content → Booking
Turn travel articles into bookable experiences
Publishers and content platforms can monetize travel content by transforming inspiration into action. Extract trip details from articles and provide instant booking options.
Recommended Endpoint:
Flight Enrichment
Add hotels, cars & activities to flight bookings
OTAs and flight search engines can increase order value by intelligently suggesting complementary services. Our API builds complete trip packages from single flight bookings.
Recommended Endpoint:
/v1/validate-onlyValidate Travel Plan (Quality Gate)
NEW: Modular Validation API
Validate an AI-generated or structured travel plan without making any API calls to booking providers. Returns a feasibility score (0-100) and detailed warnings.
Use Cases:
- AI Travel Planners wanting to validate generated itineraries
- Travel Agent Copilots checking plan feasibility
- Quality gates before presenting plans to users
- No real-time pricing/availability checks
- No itinerary modification or 'fixing'
- Pure validation: feasibility score + warnings
- Accepts standardized structured input (no NLP parsing)
Key Differences from /v1/ingest:
curl -X POST https://must-seen.com/api/v1/validate-only \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "AI-Generated Trip",
"segments": [
{
"type": "FLIGHT",
"origin": {"code": "JFK"},
"destination": {"code": "MUC"},
"departure_time": "2025-09-15T18:00:00Z"
},
{
"type": "HOTEL",
"location": {"city": "Munich"},
"check_in": "2025-09-16",
"check_out": "2025-09-19"
}
],
"travelers": 2
}'{
"valid": true,
"feasibility_score": 92,
"quality_rating": "excellent",
"summary": "Trip is well-structured and bookable",
"warnings": [],
"statistics": {
"total_segments": 2,
"issues_found": 0
}
}Request Body
name Trip name/identifiersegments Array of trip segments (flights, hotels, activities)travelers Number of travelersResponse
valid Whether the trip is validfeasibility_score Trip feasibility scorewarnings List of validation warnings with severity/v1/ingestParse, Enrich & Validate a Travel Plan (Synchronous)
Full pipeline processing: Parse unstructured text, extract trip segments, validate coherence, and enrich with real-time pricing and availability from booking providers.
curl -X POST https://must-seen.com/api/v1/ingest \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"planText": "Planning a trip to Paris next month. Flying from Berlin on the 20th, staying for 3 nights at a nice hotel near the Eiffel Tower."
}'Request Body
planText Unstructured travel plan textResponse
id Unique trip identifiersegments Parsed and enriched trip segments with pricingvisual_output Formatted itinerary for display