POST
/
order
/
create
{
  "data": {
    "orderId": "<string>",
    "bookingReferences": [
      {
        "type": "<string>",
        "id": "<string>",
        "airlineCode": "<string>"
      }
    ],
    "orderItems": [
      {
        "orderItemId": "<string>",
        "flightItem": {
          "origin": "<string>",
          "destination": "<string>",
          "departureDate": "<string>",
          "marketingCarrier": "<string>",
          "operatingCarrier": "<string>",
          "flightNumber": "<string>",
          "classOfService": "<string>"
        },
        "price": {
          "totalAmount": "<string>",
          "baseAmount": "<string>",
          "currencyCode": "<string>"
        },
        "passengerReferences": [
          "<string>"
        ]
      }
    ],
    "status": "CONFIRMED",
    "ticketingTimeLimits": {
      "deadline": "<string>"
    },
    "passengers": [
      {
        "passengerId": "<string>",
        "type": "<string>",
        "givenName": "<string>",
        "surname": "<string>",
        "middleName": "<string>"
      }
    ],
    "creationDate": "<string>",
    "lastModifiedDate": "<string>"
  }
}

​
Orders

Create and manage flight orders using NDC 24.4 standards.

​
Request Format

POST https://engine-api.travelese.ai/order/create

​
Response Format

The endpoint returns a JSON response with the following structure:

{
  "success": true,
  "requestId": "req_123",
  "data": {
    "orderId": "ORD123456",
    "bookingReferences": [
      {
        "type": "PNR",
        "id": "ABC123",
        "airlineCode": "AC"
      }
    ],
    "orderItems": [
      {
        "orderItemId": "ITEM1",
        "flightItem": {
          "origin": "YTO",
          "destination": "TYO",
          "departureDate": "2025-06-15",
          "marketingCarrier": "AC",
          "operatingCarrier": "AC",
          "flightNumber": "1",
          "classOfService": "Y"
        },
        "price": {
          "totalAmount": "1000.00",
          "baseAmount": "800.00",
          "currencyCode": "USD"
        },
        "passengerReferences": ["PAX1"]
      }
    ],
    "status": "CONFIRMED",
    "ticketingTimeLimits": {
      "deadline": "2025-06-14T23:59:59Z"
    },
    "passengers": [
      {
        "passengerId": "PAX1",
        "type": "ADT"
      }
    ]
  }
}

​
Error Response

{
  "success": false,
  "requestId": "req_123",
  "error": {
    "code": "invalid_request",
    "message": "Detailed error message"
  }
}

​
Example Request

curl -X POST "https://engine-api.travelese.ai/order/create" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "AMADEUS",
    "offerId": "OFF123456",
    "passengers": [
      {
        "type": "ADT",
        "individual": {
          "givenName": "John",
          "surname": "Doe",
          "birthdate": "1990-01-01",
          "gender": "M",
          "nameTitle": "MR"
        },
        "contact": {
          "email": "[email protected]",
          "phone": {
            "number": "1234567890",
            "countryDialingCode": "1"
          }
        }
      }
    ],
    "payment": {
      "method": "CREDIT_CARD",
      "amount": {
        "value": "1000.00",
        "currencyCode": "USD"
      }
    }
  }'

​
Usage

Use this endpoint to:

  • Create new flight orders
  • Retrieve order details
  • Cancel existing orders
  • Track order status and ticketing deadlines

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Order creation request

The body is of type object.

Response

201
application/json

Order created successfully

The response is of type object.