API Information

Response Format
JSON
Method/Endpoint
/v3.0.0/shop/altdates/flights/
Current Version
3.0.0
Target Audience
TN
Environment
Production
Documentation
Go to the Alternate Date documentation

What's New

  • Bargain FinderSM Max has been enhanced to enable more flexibility within the request and return additional information in the response as follows: • Schedule Filtering – new elements were added to the request schema: *Search by Airport or City codes – Allows you to specify for Origin/Destination if search should be proceed for city or airport code *Preferred Operating Carrier– Allows you to narrow the search by operating carrier (following the same logic as the current element for the marketing carrier). • Baggage Enhancement - Allows you to manage baggage information search at the request level. • Non BSP check - Allows you to select a validating carrier and override the local settlement validation method and Interline Electronic Ticketing (IET) validation.

Business Value

  • Each of these enhancements enable greater personalization and efficiency to further refine the search. Results are more relevant options, which drives higher booking conversion.

New Features

In the Request

Required

Parameter: RequestType

Type: BaggageRequestType

Description: Baggage information request type. Valid values are: • “A” - Allowance only • “C” - Allowance and charges • “N” - No baggage information

Sample Value:

"Baggage": { "RequestType": "A", "Description": true }
Note: The “RequestType” parameter is required within the “Baggage” element.
Parameter: SettlementValidation

Type: Boolean

Description: The “SettlementValidation” parameter allows you to override the local settlement plan check.

Sample Value:

N/A
Note: When SettlementValidation/@Ind is set to false, it disables the settlement method validation in the local point of sale. When SettlementValidation/@Ind is set to true, it validates the settlement method in the local POS. If specified along with Carrier Code, the settlement validation will be disabled (if “false”) or proceed (if “true”) for the carriers specified in the request; if no Carrier Code is specified, the settlement validation will be disabled/proceed for all validating carriers. If a country code(s) is provided, the settlement validation will be triggered for the specified country/countries). The “SettlementValidation” element is required within the “ValidatingCarrierCheck” element.
Parameter: IETValidation

Type: Boolean

Description: IETValidation allows you to disable Electronic Ticketing agreements validation or specify in which points of sale and for which carriers Electronic Ticketing agreements should be checked.

Sample Value:

N/A
Note: When IETValidation/@Ind is set to “false,” it disables the Interline Electronic Ticketing agreements validation. When IETValidation/@Ind is set to “true,” at least one Country Code must be specified and will trigger IET validation performed in the specified countries. The “IETValidation” element is required within the “ValidatingCarrierCheck” element.

Optional

Parameter: LocationType

Type: String

Description: Parameter to narrow origin/destination search to specified airport or city. Valid values are: • “A” - Airport code • “C” - City code

Sample Value:

"DestinationLocation": { "LocationCode": "OSL", "LocationType": "A" }
Note: If no “LocationType” is specified, the “LocationCode” will default to a city code (if city and airport codes are the same).
Parameter: Type

Type: PreferLevelType

Description: “Type” parameter allows you to narrow the search by carrier type. Valid values are: • “Marketing” • “Operating”

Sample Value:

N/A
Note: If no “Type” parameter is added, vendor preference defaults to the marketing carrier.
Parameter: Baggage

Type: Complex

Description: Element to request baggage information.

Sample Value:

N/A
Note: If the “Baggage” element is added, the parameter “RequestType” is required. Current baggage information, allowance only, will be returned if the “Baggage” element is not added to the request.
Parameter: Description

Type: Boolean

Description: The “Description” parameter allows you to request baggage text information. Valid values are: • “true” - To request text information. • “false” – Not to request text information.

Sample Value:

"Baggage": { "RequestType": "A", "Description": true }
Note: If “RequestType” is set to “N”, the “Description” parameter will be ignored. If no “Description” parameter is specified in the request, it is considered as “false”.
Parameter: ValidatingCarrierCheck

Type: Complex

Description: The ValidatingCarrierCheck element encompasses the elements allowing you to override the local settlement method validation and Interline Electronic Ticketing agreements.

Sample Value:

N/A
Parameter: Carrier/@Code

Type: String

Description: Carrier/@Code parameter allows you to specify a carrier code(s) for which the specified settlement method and/or IET validation should (should not) be done.

Sample Value:

"ValidatingCarrierCheck": { "SettlementValidation": { "Ind": false }, "IETValidation": { "Ind": true }, "Carrier": [{ "Code": "QR" }, { "Code": "EY" }], "Country": [{ "Code": "DE" }, { "Code": "FR" }, { "Code": "IT" }] }
Note: If a carrier code is not added in the request, the settlement validation is enabled/disabled for all carriers.
Parameter: Country/@Code

Type: String

Description: Country/@Code parameter allows you to specify country code(s) for which IET and/or settlement validation should be performed. At least one country code must be provided if IETValidation/@Ind is set to “true”.

Sample Value:

"ValidatingCarrierCheck": { "SettlementValidation": { "Ind": false }, "IETValidation": { "Ind": true }, "Carrier": [{ "Code": "QR" }, { "Code": "EY" }], "Country": [{ "Code": "DE" }, { "Code": "FR" }, { "Code": "IT" }] }
Note: Country code is a valid parameter only if IET Validation is set to “true” in the request; otherwise, it is ignored. The format is a two-character country code as defined by ISO.

In the Response

Required

Parameter: EquivalentAmount

Type: MonetaryAmountType

Description: Equivalent amount for baggage charges.

Sample Value:

N/A
Note: “EquivalentAmount” is required within the “Charge” element.
Parameter: EquivalentCurrency

Type: CurrencyCodeType

Description: Equivalent currency for baggage charges.

Sample Value:

N/A
Note: “EquivalentCurrency” is required within the “Charge” element.

Optional

Parameter: ProvisionType

Type: Baggage Provision Type

Description: “ProvisionType” indicates baggage information. Valid values are: • “A” - Checked Baggage Allowance. • “C” - Day of Check-in Charges.

Sample Value:

"BaggageInformation": [{ "ProvisionType": "A", "AirlineCode": "SK", "Segment": [{ "Id": 0 }, { "Id": 1 }], "Allowance": [{ "Pieces": 1, "Description1": "UP TO 50 POUNDS/23 KILOGRAMS" }] }]
Parameter: AirlineCode

Type: AirlineCodeType

Description: “AirlineCode” indicates the carrier whose baggage provisions apply.

Sample Value:

"BaggageInformation": [{ "ProvisionType": "A", "AirlineCode": "SK", "Segment": [{ "Id": 0 }, { "Id": 1 }], "Allowance": [{ "Pieces": 1, "Description1": "UP TO 50 POUNDS/23 KILOGRAMS" }] }]
Parameter: Description1

Type: String

Description: Baggage text information.

Sample Value:

"BaggageInformation": [{ "ProvisionType": "A", "AirlineCode": "SK", "Segment": [{ "Id": 0 }, { "Id": 1 }], "Allowance": [{ "Pieces": 1, "Description1": "UP TO 50 POUNDS/23 KILOGRAMS" }] }]
Parameter: Description2

Type: String

Description: Baggage text information.

Sample Value:

N/A
Parameter: Charge

Type: Complex

Description: Charge information for the first two checked bags (if applicable).

Sample Value:

N/A
Note: If the “Charge” element is applicable, the “EquivalentAmount” and “EquivalentCurrency” parameters are required.
Parameter: FirstPiece

Type: Byte

Description: Specify first baggage piece for which the specified charge information applies.

Sample Value:

N/A
Note: “FirstPiece” can be the same as “LastPiece” if the specified charge applies to one piece only.
Parameter: LastPiece

Type: Byte

Description: Specify last baggage piece for which the specified charge information applies.

Sample Value:

N/A
Note: “LastPiece” can be the same as “FirstPiece” if the specified charge applies to one piece only.
Parameter: SettlementMethod

Type: String (Length 3 characters)

Description: The “SettlementMethod” parameter describes the settlement method verified for validating carrier(s).

Sample Value:

"ValidatingCarrierCheck": { "SettlementValidation": { "Ind": false }, "IETValidation": { "Ind": true }, "Carrier": [{ "Code": "QR" }, { "Code": "EY" }], "Country": [{ "Code": "DE" }, { "Code": "FR" }, { "Code": "IT" }] }
Note: If no settlement method is checked (SettlementValidation Ind="false" in request), NSP appears in the response.
Parameter: NewVcxProcess

Type: Boolean

Description: “NewVcxProcess” indicates whether IET validation was requested (by IETValidation Ind set as “true" or “false” in the request).

Sample Value:

"ValidatingCarrier": [{ "SettlementMethod": "ARC", "NewVcxProcess": true, "Default": { "Code": "MS" } }, { "SettlementMethod": "BSP", "Country": "IT", "NewVcxProcess": true, "Default": { "Code": "HR" }, "Alternate": [{ "Code": "HV" }] }]
Parameter: Default/@Code

Type: CarrierCode

Description: This parameter indicates the default carrier code for Settlement Method and IET validation check.

Sample Value:

"ValidatingCarrier": [{ "SettlementMethod": "ARC", "NewVcxProcess": true, "Default": { "Code": "MS" } }, { "SettlementMethod": "BSP", "Country": "IT", "NewVcxProcess": true, "Default": { "Code": "HR" }, "Alternate": [{ "Code": "HV" }] }]
Parameter: Alternate/@Code

Type: CarrierCode

Description: This parameter indicates the alternate carrier code for Settlement Method and IET check.

Sample Value:

"ValidatingCarrier": [{ "SettlementMethod": "ARC", "NewVcxProcess": true, "Default": { "Code": "MS" } }, { "SettlementMethod": "BSP", "Country": "IT", "NewVcxProcess": true, "Default": { "Code": "HR" }, "Alternate": [{ "Code": "HV" }] }]
Parameter: Country/@Code

Type: String

Description: Returns the country code in which IET validation was done for the default or alternate Validating Carrier. The format is a two-character country code as defined by ISO.

Sample Value:

"ValidatingCarrier": [{ "SettlementMethod": "ARC", "NewVcxProcess": true, "Default": { "Code": "MS" } }, { "SettlementMethod": "BSP", "Country": "IT", "NewVcxProcess": true, "Default": { "Code": "HR" }, "Alternate": [{ "Code": "HV" }] }]
Note: Above schema applies if no settlement method with IET validation checked in request: |-|SettlementValidation Ind="false"/|--| |-|IETValidation Ind="true"/|--|
Parameter: Country

Type: String

Description: Country code for which settlement method and IET validation was checked (other than the original POS). Format is a two-character country code as defined by ISO.

Sample Value:

"ValidatingCarrier": [{ "SettlementMethod": "ARC", "NewVcxProcess": true, "Default": { "Code": "MS" } }, { "SettlementMethod": "BSP", "Country": "IT", "NewVcxProcess": true, "Default": { "Code": "HR" }, "Alternate": [{ "Code": "HV" }] }]
Note: This schema applies if settlement method with IET validation check was requested: |-|SettlementValidation Ind="true"/|--| |-|IETValidation Ind="true"/|--| |-|Country Code="PL"/|--|