​
Quickstart Guide

This guide will help you get started with the Travelese Engine API. We’ll walk through a complete flight booking flow, from searching for flights to managing orders and services.

​
Prerequisites

Before you begin, you’ll need:

  1. A Travelese API key (contact [email protected] to get one)
  2. Basic knowledge of REST APIs
  3. A tool to make HTTP requests (curl, Postman, etc.)

​
Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer your-api-key

​
Basic Flow

A typical flight booking flow consists of these steps:

  1. Search for flights
  2. Create an order
  3. Add services (optional)
  4. Manage the order

Let’s go through each step.

​
1. Search for Flights

First, search for available flights using the Shop Flights endpoint:

curl -X GET "https://engine-api.travelese.ai/shop/flight?origin=LHR&destination=JFK&departureDate=2024-04-01" \
  -H "Authorization: Bearer your-api-key"

This will return a list of available flight offers. Note down the offerId of your chosen flight.

​
2. Create an Order

Once you have an offer ID, create an order:

curl -X POST "https://engine-api.travelese.ai/order/create" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "duffel",
    "offerId": "off_0000AEF8DEC9C7",
    "passengers": [
      {
        "type": "ADULT",
        "title": "MR",
        "firstName": "John",
        "lastName": "Doe",
        "email": "[email protected]",
        "phone": "+1234567890",
        "birthDate": "1990-01-01",
        "gender": "M",
        "nationality": "US",
        "documentType": "PASSPORT",
        "documentNumber": "123456789",
        "documentExpiryDate": "2025-01-01",
        "documentIssuingCountry": "US"
      }
    ],
    "paymentDetails": {
      "type": "CARD",
      "amount": "1000.00",
      "currency": "USD"
    }
  }'

Save the orderId from the response for the next steps.

​
3. Add Services (Optional)

You can add services like seat selection to your order:

  1. First, list available services:
curl -X GET "https://engine-api.travelese.ai/service/list?orderId=ord_0000AEF8DEC9C7&provider=duffel" \
  -H "Authorization: Bearer your-api-key"
  1. Then, add a service to your order:
curl -X POST "https://engine-api.travelese.ai/service/add" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "duffel",
    "orderId": "ord_0000AEF8DEC9C7",
    "serviceId": "ase_0000AEF8DEC9C7",
    "passengerIds": ["pas_1"],
    "segmentIds": ["seg_1"]
  }'

​
4. Manage the Order

You can retrieve or cancel your order as needed:

  1. Retrieve order details:
curl -X GET "https://engine-api.travelese.ai/order/ord_0000AEF8DEC9C7?provider=duffel" \
  -H "Authorization: Bearer your-api-key"
  1. Cancel the order if necessary:
curl -X POST "https://engine-api.travelese.ai/order/ord_0000AEF8DEC9C7/cancel" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "duffel",
    "reason": "CUSTOMER_REQUEST"
  }'

​
Error Handling

All endpoints return standardized error responses:

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}

Common error codes include:

  • invalid_request: Missing or invalid parameters
  • invalid_credentials: Invalid API key
  • not_found: Resource not found
  • provider_error: Error from the underlying provider

​
Next Steps

Now that you’re familiar with the basic flow, you can:

  1. Explore the complete API Reference
  2. Learn about Airlines and Airports
  3. Join our Discord community for support

​
Need Help?

If you have any questions or need assistance:

Was this page helpful?