Order
Create and manage flight orders
{
"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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Provider to use for the order
amadeus, duffel, any "amadeus"
Offer ID to book (NDC: OfferID)
"OFF123456"
Passenger information (NDC: PassengerList)
Passenger information (NDC: Passenger)
Passenger type code (NDC: PTC)
ADT, CHD, INF Individual information (NDC: Individual)
Given name (NDC: GivenName)
Surname (NDC: Surname)
Birthdate in YYYY-MM-DD format (NDC: Birthdate)
Gender (NDC: Gender)
M, F, X Name title (NDC: NameTitle)
MR, MS, MRS, MISS, DR Middle name (NDC: MiddleName)
Contact information (NDC: Contact)
Email address (NDC: EmailContact)
Travel documents (NDC: Document)
Document type (NDC: DocumentType)
PASSPORT, ID_CARD, VISA Document number (NDC: DocumentNumber)
Issuing country code (NDC: IssuingCountry)
Expiry date in YYYY-MM-DD format (NDC: ExpiryDate)
Currency code for pricing (NDC: CurrencyMetadata/CurrencyCode)
"USD"
Payment information (NDC: Payment)
Payment method (NDC: Method)
CREDIT_CARD, DEBIT_CARD, BANK_TRANSFER Card information (NDC: Card)
Card number (NDC: CardNumber)
Card holder name (NDC: CardHolderName)
Expiry month (NDC: ExpiryMonth)
Expiry year (NDC: ExpiryYear)
Card verification value (NDC: CVV)
{
"method": "CREDIT_CARD",
"amount": { "value": "1000.00", "currencyCode": "USD" },
"card": {
"cardNumber": "4111111111111111",
"cardHolderName": "John Doe",
"expiryMonth": "12",
"expiryYear": "2025",
"cvv": "123"
}
}
Response
Order (NDC: Order)
Order identifier (NDC: OrderID)
Order items (NDC: OrderItems)
Order item identifier (NDC: OrderItemID)
Flight item (NDC: FlightItem)
Origin location code (NDC: Origin)
Destination location code (NDC: Destination)
Departure date (NDC: DepartureDate)
Marketing carrier code (NDC: MarketingCarrier)
Operating carrier code (NDC: OperatingCarrier)
Flight number (NDC: FlightNumber)
Class of service (NDC: ClassOfService)
References to passengers (NDC: PassengerReferences)
Order status (NDC: Status)
CONFIRMED, PENDING, CANCELLED Ticketing time limits (NDC: TicketingTimeLimits)
Ticketing deadline (NDC: Deadline)
Passengers (NDC: Passengers)
Passenger identifier (NDC: PassengerID)
Passenger type code (NDC: PTC)
Given name (NDC: GivenName)
Surname (NDC: Surname)
Middle name (NDC: MiddleName)
Order creation date (NDC: CreationDate)
Last modified date (NDC: LastModifiedDate)
{
"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>"
}
}