Products
A clean surface for search, availability, structured pricing, and merchandising logic.
- Catalog discovery
- Availability windows
- Price composition
A restrained, production-grade layer for product discovery, booking flow, payment orchestration, and MCP-connected agent experiences.
Core Modules
One API surface, four clean domains
Products
Catalog discovery, pricing, and availability.
Cart
Session-aware booking composition.
Orders
Confirmation, lifecycle, and modifications.
Payments
Settlement, refund, and status workflows.
Operating Model
Use the REST APIs directly for product, cart, order, and payment orchestration.
Layer MCP agents on top when you want conversational search, support, and internal operations.
Instead of spreading business logic across isolated products, the API keeps catalog, booking state, orders, and payment flows aligned.
Why this redesign is quieter
Readable structure
The product surface is designed to be scanned quickly by product teams, backend engineers, and partner operations.
Thin onboarding path
You can move from API key to first booking workflow without navigating a maze of setup pages.
MCP-ready by default
The same core primitives support human-built flows and agent-based experiences.
A clean surface for search, availability, structured pricing, and merchandising logic.
Compose multi-item bookings with state you can inspect and mutate predictably.
Move from tentative selections to confirmed fulfillment without ad hoc workflow glue.
Handle settlement, status tracking, and refund paths with a single operational model.
The API stays useful on its own. MCP extends it when you want natural-language search, operational copilots, or support automation.
const response = await fetch('https://api.tripguru.ai/v1/products?city=Paris', {
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
})
const { products } = await response.json()
const cart = await fetch('https://api.tripguru.ai/v1/cart/items', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
productId: products[0].id,
quantity: 2
})
})
Guide a traveler from search to checkout inside a conversational assistant.
Let support teams inspect orders and payment state without switching between tools.
Use agents to summarize booking changes, refund status, and inventory gaps.
Request an API key and confirm your environment, rate limits, and support channel.
Build the first flow around product lookup, cart creation, and order confirmation.
Add agent capabilities only after the core transactional path is stable.
These are the first endpoints most teams touch when building a travel booking flow.
Documentation focus
We bias the docs toward practical sequences, response structure, and operational concerns instead of decorative marketing copy.
/api/v1/productsQuery the active catalog with filters, pagination, and inventory context.
/api/v1/cart/itemsAdd a product selection to an existing booking session.
/api/v1/ordersPromote a validated cart into a confirmed order with customer context.
/api/v1/paymentsInitialize payment collection for a pending order.
The fastest path is still the best path: authenticate, fetch products, create a cart, promote to order, collect payment.