AirOrderCreate

You can use this endpoint to book the air ticket using various options such as Offer ID, Shopping Response ID, Offer Response ID, Seat Response ID, Itinerary ID, and a few more parameters.

Schema

  • Name: Provide the name for the request. This is a String value.

  • ReferenceVersion: Provide the version number. This is a Numeric value.


  • Travel Agency Sender:

    • Name: Provide the name for the request. This is a String value.

    • IATA Number: Provide the IATA number for the request. This is a String value.

    • Agency ID: Provide the agency ID. This is a String value.

    • Contacts: This is an Array.

      • EmailContact: Provide the email contact for the request. This is a String value.

This is a required field. Provide the shopping response ID for a specific selection. The value will be Numeric.

This is a required field. Provide the offer response ID for a specific selection. The value will be Numeric.

This is an optional field. Provide the seat response ID for a specific selection. The value will be Numeric.

This is an optional field. Provide the service list response ID for a specific selection. The value will be Numeric.

  • Tracking: Valid values are Y andN. This is a String value.

  • PassengerMetadata:

    • SpecialServiceRequest: This is an Array.

      • PassengerID: This is the Passenger ID. This is a String value.

      • Origin: This is the Origin. This is a String value.

      • Destination: This is the Destination. This is a String value.

      • DepartureDateTime: This is the Departure date and time. This is a String value. .

      • MarketingFlightNumber: This is the Marketing flight number. This is a Numeric value.

      • MarketingCarrier: This is the Marketing carrier. This is a String value.

      • SsrType: This is the Ssr type. This is a String value.

      • SsrCode: This is the Ssr code. This is a String value.

      • FreeText: This is the Free text. This is a String value.


  • OfferID: This is a required field. Provide the offer ID for a specific selection. This is a String value.

  • ServiceList: This is an optional field. This is a String value.

    • OptinalServiceId: Provide the optional service Id.

    • PassengerID: Provide the passenger ID.

  • Seat: This is an optional field. This is a String value.

    • SeatId: Provide the seat ID. This is a String value.

    • PassengerID: Provide the passenger ID. This is a String value.


This is a required field. Provide the Booking type for a specific selection. Valid values are BOOK and HOLD. If the value selected is HOLD then payment has to be confirmed before confirming the order.

This is an Array.

  • Type: This is a required field. Provide the payment type. Valid values are CARD and CHEQUE. This is a String value.

  • Amount: This is a required field. Provide the amount. This is a Numeric value.

  • OnflyMarkup: This is an optional field and a String value.

  • OnflyDiscount: This is an optional field and a String value.

  • PromoCode: This is an optional field. Enter the associated promo code. This is a String value.

  • PromoDiscount: This is an optional field. Enter the associated promo discount. This is a String value.

  • Method:

    • CardCode: Provide the card code. This is a String value.

For Card Type CC possible Card Codes are AX, DC, DI, DUS, JC, MA, MC, VI. For Card Type DC possible Card Codes are MC, RU, and VI.

  • CardNumber: Provide the card number. This is a String value.

  • SeriesCode: Provide the card number. This is a String value.

  • CardHolderName: Provide the card holder name. This is a String value.

  • EffectiveExpireDate: Provide the Effective date and Expiration date. This is a String value.

  • Payer:

    • ContactInfoRefs:

  • Passenger: This is an Array. Note: This is a required field. The passenger list must have at least one adult. Infant object count should be less than or equal to adult count. Total pax should be less than or eqaul to 9.

    • PassengerID: Provide the passenger ID for the request. This is a String value.

    • PTC: Valid values are ADT, CHD, and INF. This is a String value.

    • BirthDate: Provide the birth date. This is a Numeric value.

    • NameTitle: Provide the title of the name. Valid values are Mrs, Miss, Ms, and Mstr. This is a String value.

    • FirstName: Provide the first name. This is a String value.

    • MiddleName: Provide the middle name. This is a String value.

    • LastName: Provide the last name. This is a String value.

    • Gender: Provide the middle name. Valid values are Male and Female. This is a String value.

    • TravelDocument: This is an Array. Provide the details of travel document. This is an optional field.

      • DocumentNumber: This is the document number of your passport. This is a String value.

      • DocumentType: This is the document type of your passport (P). This is a String value.

      • ExpiryDate: This is the Expiry date of your passport. This is a Numeric value.

      • IssuingCountry: This is the Issuing country of your passport. This is a String value.

    • ContactInfoRef: Provide the contact information details. This is a String value.


This is an Array. This is a required field. Provide all the Contact information here.

  • ContactID: Provide the contact ID.

  • AgencyName: Provide the agency name.

  • EmailAddress: Provide the email address.

  • Phone:

    • CountryCode: Provide the country code.

    • AreaCode: Provide the area code.

    • PhoneNumber: Provide the phone number.

  • Mobile:

    • CountryCode: Provide the country code.

    • MobileNumber: Provide the mobile number.

  • Address:

    • Street: This is an Array. Provide the street details.
    • CityName: Provide the city name.
    • StateProv: Provide the state province.
    • PostalCode: Provide the postal code.
    • CountryCode: Provide the country code.
  • PassengerContact: Provide the contact details.

    • EmailAddress: Provide your email ID. This is a String value.

    • Phone:

      • CountryCode: Provide the country code. This is a String value.

      • AreaCode: Provide the area code. This is a String value.

      • PhoneNumber: Provide the phone number. This is a Numeric value.


Request URL Sample

curl --location --request POST 'https://newapi.tltid.com/AirOrderCreate' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \

Request Body Sample

{
    "OrderCreateRQ": {
        "Document": {
            "Name": "kathir",
            "ReferenceVersion": "1.0"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "kathir",
                    "IATA_Number": "",
                    "AgencyID": "",
                    "Contacts": {
                        "Contact": [
                            {
                                "EmailContact": "kathir@gmail.com"
                            }
                        ]
                    }
                }
            }
        },
        "ShoppingResponseId": "1620733717868695577",
        "OfferResponseId": "1620733746672400040",
        "SeatResponseId": "",
        "ServiceListResponseId": "",
        "MetaData": {
            "Tracking": "Y",
            "PassengerMetadata": {
                "SpecialServiceRequest": [
                    {
                        "PassengerID": "ADT1",
                        "Origin": "LAX",
                        "Destination": "EWR",
                        "DepartureDateTime": "2021-06-19",
                        "MarketingFlightNumber": "3058",
                        "MarketingCarrier": "UA",
                        "SsrType": "SSR",
                        "SsrCode": "Ambulatory",
                        "FreeText": "jk"
                    },
                    {
                        "PassengerID": "ADT1",
                        "Origin": "LAX",
                        "Destination": "EWR",
                        "DepartureDateTime": "2021-06-19",
                        "MarketingFlightNumber": "3058",
                        "MarketingCarrier": "UA",
                        "SsrType": "SSR",
                        "SsrCode": "FREE MEAL",
                        "FreeText": "SSRRR"
                    }
                ]
            }
        },
        "Query": {
            "Order": {
                "Offer": [
                    {
                        "OfferID": "151711620733725566476905"
                    }
                ],
                "ServiceList": [],
                "Seat": []
            }
        },
        "BookingType": "BOOK",
        "PromoCode": "",
        "PromoDiscount": 0,
        "Payments": {
            "Payment": [
                {
                    "Type": "CARD",
                    "Amount": 129.61,
                    "OnflyMarkup": "0.00",
                    "OnflyDiscount": "0.00",
                    "Method": {
                        "PaymentCard": {
                            "CardType": "CC",
                            "CardCode": "AX",
                            "CardNumber": "345678000000007",
                            "SeriesCode": "4111",
                            "CardHolderName": "Kumar",
                            "EffectiveExpireDate": {
                                "Effective": "",
                                "Expiration": "2022-05"
                            }
                        }
                    },
                    "Payer": {
                        "ContactInfoRefs": "CTC1"
                    }
                }
            ]
        },
        "DataLists": {
            "PassengerList": {
                "Passenger": [
                    {
                        "PassengerID": "ADT1",
                        "PTC": "ADT",
                        "BirthDate": "2000-07-21",
                        "NameTitle": "Mr",
                        "FirstName": "downey",
                        "MiddleName": "",
                        "LastName": "Robert",
                        "Gender": "Male",
                        "TravelDocument": [
                            {
                                "DocumentNumber": "9658745",
                                "DocumentType": "P",
                                "ExpiryDate": "2024-01-01",
                                "IssuingCountry": "CA"
                            }
                        ],
                        "ContactInfoRef": "CTC1"
                    }
                ]
            },
            "ContactList": {
                "ContactInformation": [
                    {
                        "ContactID": "CTC1",
                        "AgencyName": "kathir",
                        "EmailAddress": "kathir@gmail.com",
                        "Phone": {
                            "ContryCode": "+91",
                            "AreaCode": "",
                            "PhoneNumber": "9854785465"
                        },
                        "Mobile": {
                            "ContryCode": "+91",
                            "MobileNumber": "9854785465"
                        },
                        "Address": {
                            "Street": [
                                "kovil Street",
                                null
                            ],
                            "CityName": "chennai",
                            "StateProv": "AX",
                            "PostalCode": "600028",
                            "CountryCode": "CA"
                        },
                        "PassengerContact": {
                            "EmailAddress": "mosris@gmail.com",
                            "Phone": {
                                "ContryCode": "",
                                "AreaCode": "",
                                "PhoneNumber": "9856325698"
                            }
                        }
                    }
                ]
            }
        }
    }
}

Response Sample

{
    "OrderViewRS": {
        "Document": {
            "Name": "Clarity NDC GATEWAY",
            "ReferenceVersion": "1.2"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "EXTERNAL API TESTING AGENCY",
                    "IATA_Number": "",
                    "AgencyID": "EXTERNAL API TESTING AGENCY",
                    "Contacts": {
                        "Contact": [
                            {
                                "EmailContact": "ba.laqaems@gmail.com"
                            }
                        ]
                    }
                }
            }
        },
        "ShoppingResponseId": "1620733717868695577",
        "Errors": {
            "Error": {
                "ShortText": "INVALID_PRICE_RES_ID",
                "Code": 32,
                "Value": "Invalid Offer Response Id or Price Response was expired"
            }
        }
    }
}

Try it out!