This endpoint will be deprecated soon, please start using AirOrderCreateV2.
Creates a booking with an airline based on an offer. When presenting an order confirmation to your customers (e.g. on screen or in an email), you should include the booking_reference which is the PNR and details of the full itinerary and show the full name of the operating carrier of each segment.
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.
-
-
Tracking: Valid values are
YandN. 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.
-
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
CARDandCHEQUE. 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 count should be less than or equal to adult count. Total pax should be less than or equal to 9.
-
PassengerID: Provide the passenger ID for the request. This is a String value.
-
PTC: Valid values are
ADT,CHD, andINF. This is a String value. -
BirthDate: Provide the birth date. This is a Numeric value.
-
NameTitle: Provide the title for the given name. This is a String value. Valid values are,
- ADT/Male:
Mr - ADT/Female:
MrsandMs - CHD/Male:
Mstr - CHD/Female:
Miss - INF/Male:
Mstr - INF/Female:
Miss
- ADT/Male:
-
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 gender of the passenger. Valid values are
MaleandFemale. This is a String value. -
TravelDocument: This is an optional field. Provide the details of travel document. This is an Array.
-
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 or province name.
- 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"
}
}
}
}