Hold GDS
This method is used to create a booking hold for Non-LCC airlines. Every Non LCC airline must be placed on Hold first before ticketing. It will not work for LCC airline because LCC airline is ticketed directly. Price verification is done before creating a booking and PNR No. is returned in case of a successful booking. In case of Price change or Time change, you will get new fare and/or new time in Book response with IsPriceChanged node and/or IsTimeChanged node set as 'true'.
The price comparison is to be made at the client’s end, and Book request needs to be sent again with the updated fare and/ or updated time. Passenger’s Date of Birth and Passport details are optional in book request wherever applicable. However, if not provided in book request then the same needs to be provided in Ticket request.
If the operator does not accept GST then it will not be added
Service URL (REST) to be used:
Hold GDS Request
| Level | Element | Format | Comments | Mandatory |
|---|---|---|---|---|
| 1 | EndUserIp | String | Public IP address of the end user initiating the flight search request. Used for security, tracking, and compliance purposes. | Mandatory |
| 2 | ClientId | String | Unique client identifier assigned to the agency during API registration and onboarding. | Mandatory |
| 3 | UserName | String | API username assigned to the agency for authentication and authorization. | Mandatory |
| 4 | Password | String | API password assigned to the agency for authentication. This credential must be transmitted securely. | Mandatory |
| 5 | SrdvType | String | Identifier representing the response type or data version returned by the SRDV system. Used internally to classify and process search results. | Mandatory |
| 6 | SrdvIndex | String | Unique SRDV reference identifier associated with the selected flight result. Required for subsequent operations such as fare validation, booking, and ticket issuance. | Mandatory |
| 7 | TraceId | String | Trace ID returned in the search response. This value must be echoed back in subsequent requests and can be used to trace a specific search or booking within the SRDV system. | Mandatory |
| 8 | ResultIndex | String | Unique identifier of the selected flight result returned in the search response. This value is required for Fare Quote, Booking, and other follow-up API operations. | Mandatory |
| 9 | Passengers[] | Array | List of passengers included in the booking. | Mandatory |
| 9.1 | Title | String | Passenger title (Mr, Mrs, Miss, etc.). | Mandatory |
| 9.2 | FirstName | String | Passenger's first name as per passport/ID. | Mandatory |
| 9.3 | LastName | String | Passenger's last name as per passport/ID. | Mandatory |
| 9.4 | PaxType | String | Pax Type ( 1- Adult, 2- Child, 3- Infant ) | Mandatory |
| 9.5 | DateOfBirth | Date Time | Passenger's date of birth. | Optional |
| 9.6 | Gender | String | Passenger gender. ( 1 – Male, 2 – Female) | Mandatory |
| 9.7 | PassportNo | String | Passenger passport number. | Optional |
| 9.8 | PassportExpiry | Date Time | Date on which the passenger's passport expires. | Optional |
| 9.9 | AddressLine1 | String | Passenger address line 1.(Max of 32 characters) | Mandatory |
| 9.10 | City | String | Passenger city of residence. | Mandatory |
| 9.11 | CountryCode | String | Country code of the passenger's residence (ISO 3166-1 alpha-2). Example: India → IN. | Mandatory |
| 9.12 | CountryName | String | Full country name. | Mandatory |
| 9.13 | ContactNo | String | Passenger contact number. | Mandatory |
| 9.14 | String | Passenger email address. | Mandatory | |
| 9.15 | Baggage[] | Array | List of baggage selections for the passenger. | Mandatory |
| 9.16 | MealDynamic[] | Array | List of meal selections for the passenger. | Mandatory |
| 9.16.1 | AirlineCode | String | Airline code associated with the selected ancillary service. | Mandatory |
| 9.16.2 | FlightNumber | String | Flight number associated with the selected ancillary service. | Mandatory |
| 9.16.3 | WayType | Integer | Indicates the journey type for which the service applies.(1 = Onward, 2 = Return) | Mandatory |
| 9.16.4 | Code | String | Service or meal code associated with the flight | Mandatory |
| 9.16.5 | Description | String | Description of the service or meal | Optional |
| 9.16.6 | AirlineDescription | String | Airline specific description of the service, if provided | Optional |
| 9.16.7 | Quantity | Integer | Number of units of the service selected | Mandatory |
| 9.16.8 | Currency | String | Currency code in which the service price is provided | Mandatory |
| 9.16.9 | Price | Decimal | Price of the selected service or meal | Mandatory |
| 9.16.10 | Origin | String | Origin airport code for which the service is applicable | Mandatory |
| 9.16.11 | Destination | String | Destination airport code for which the service is applicable | Mandatory |
| 9.17 | IsLeadPax | Boolean | Indicates whether the passenger is the lead passenger for the booking.(Value – True or False) | Mandatory |
| 9.18 | GSTCompanyAddress | String | GST registered company address. Required if IsGSTMandatory is TRUE. | Mandatory |
| 9.19 | GSTCompanyContactNumber | String | GST registered company contact number. Required if IsGSTMandatory is TRUE. | Mandatory |
| 9.20 | GSTCompanyName | String | GST registered company name. Required if IsGSTMandatory is TRUE. | Mandatory |
| 9.21 | GSTNumber | String | GST identification number. Required if IsGSTMandatory is TRUE. | Mandatory |
| 9.22 | GSTCompanyEmail | String | GST registered company email address. Required if IsGSTMandatory is TRUE. | Mandatory |
| 9.23 | Seat[] | Array | List of seat selections for the passenger. | Mandatory |
| 9.23.1 | SeatNumber | String | Selected seat number for the passenger. | Mandatory |
| 9.23.2 | IsBooked | Boolean | Indicates whether the seat is already booked | Mandatory |
| 9.23.3 | IsLegroom | Boolean | Indicates whether the seat has extra legroom | Optional |
| 9.23.4 | IsAisle | Boolean | Indicates whether the seat is an aisle seat | Optional |
| 9.23.5 | Amount | Decimal | Price charged for the selected seat | Mandatory |
| 9.23.6 | Code | String | Unique seat selection code provided by the airline | Mandatory |
| 9.24 | Fare{} | Object | Fare details associated with the selected itinerary. | Mandatory |
| 9.24.1 | Currency | String | Currency code in which the fare is quoted (e.g., INR, USD). | Mandatory |
| 9.24.2 | BaseFare | Decimal | Base fare before taxes and additional charges. | Mandatory |
| 9.24.3 | Tax | Decimal | Total applicable taxes for the booking. | Mandatory |
| 9.24.4 | YQTax | Decimal | Fuel surcharge applied by the airline. | Mandatory |
| 9.24.5 | OtherCharges | Decimal | Additional charges applicable to the booking. | Mandatory |
| 9.24.6 | TransactionFee | Decimal | Transaction processing fee charged for the booking. | Mandatory |
| 9.24.7 | AdditionalTxnFeeOfrd | Decimal | Additional Transaction Fee Offered (It will always be zero) | Mandatory |
| 9.24.8 | AdditionalTxnFeePub | Decimal | Additional transaction fee published by the supplier. | Mandatory |
| 9.24.9 | AirTransFee | Decimal | Airline transaction fee applied to the booking. | Mandatory |
Hold GDS Response
| Level | Element | Format | Comments | Mandatory |
|---|---|---|---|---|
| 1 | Error{} | Object | Contains error details returned by the API when the request cannot be processed successfully. | Mandatory |
| 1.1 | ErrorCode | String | Unique error code identifying the type of error encountered during request processing. | Mandatory |
| 1.2 | ErrorMessage | String | Human-readable description of the error returned by the API. | Mandatory |
| 2 | TraceId | String | Unique identifier assigned to the API request for tracking, debugging, and support purposes | Mandatory |
| 3 | ResponseStatus | String | Indicates whether the API request was processed successfully or failed. | Mandatory |
| 4 | SrdvType | String | Response type identifier indicating the version or category of data returned by the SRDV system. | Mandatory |
| 5 | Response{} | Object | Contains booking hold details returned by the API. | Mandatory |
| 5.1 | SrdvIndex | String | Unique SRDV reference identifier associated with the selected flight result. Required for subsequent operations such as fare validation, booking, and ticket issuance. | Mandatory |
| 5.2 | PNR | String | Passenger Name Record (PNR) generated by the airline. | Mandatory |
| 5.3 | BookingId | Integer | Unique booking id (if booking id is provided as 0,then you may call Get Booking Details method using Trace id or PNR with First Name and Last Name of the lead passenger) | Mandatory |
| 5.4 | SSRDenied | String | Indicates whether any Special Service Request (SSR) was denied. | Mandatory |
| 5.5 | SSRMessage | String | Message returned for SSR processing status. | Optional |
| 5.6 | Status | String | Status [NotSet = 0, Successful = 1, Failed = 2, OtherFare = 3, OtherClass = 4, BookedOther = 5, NotConfirmed = 6] | Mandatory |
| 5.7 | IsPriceChanged | Boolean | Represents whether price has changed or not | Mandatory |
| 5.8 | IsTimeChanged | Boolean | Represents whether time has changed or not | Mandatory |
| 5.9 | FlightItinerary{} | Object | Fare of search result | Mandatory |
| 5.9.1 | BookingId | Integer | Unique booking ID | Mandatory |
| 5.9.2 | IsManual | String | Specifies if the itinerary is manually created or system generated. | Mandatory |
| 5.9.3 | PNR | String | Passenger Name Record (PNR) generated by the airline. | Mandatory |
| 5.9.4 | IsDomestic | Boolean | Indicates whether the journey is domestic or international. (Value – True or False) | Mandatory |
| 5.9.5 | Source | String | Booking source or provider identifier | Mandatory |
| 5.9.6 | Origin | String | Journey origin airport code. | Mandatory |
| 5.9.7 | Destination | String | Journey destination airport code. | Mandatory |
| 5.9.8 | AirlineCode | String | IATA airline code (e.g., AI, 6E, UK). | Mandatory |
| 5.9.9 | LastTicketDate | String | Last date and time by which the ticket must be issued. | Mandatory |
| 5.9.10 | ValidatingAirlineCode | String | Airline code responsible for ticket validation and issuance. | Mandatory |
| 5.9.11 | AirlineRemark | String | Remarks or messages provided by the airline. | Mandatory |
| 5.9.12 | IsLCC | Boolean | Indicates whether the itinerary belongs to a Low-Cost Carrier (LCC).(Value – True or False) | Mandatory |
| 5.9.13 | NonRefundable | Boolean | Indicates whether the fare is non-refundable. (Value – True or False) | Mandatory |
| 5.9.14 | FareType | String | Type of fare selected for the booking. | Mandatory |
| 5.9.15 | CreditNoteNo | String | Credit note reference number, if applicable. | Mandatory |
| 5.9.16 | Fare{} | Object | Contains complete fare breakdown details. | Mandatory |
| 5.9.16.1 | Currency | String | Currency code used for fare calculations (e.g., INR, USD). | Mandatory |
| 5.9.16.2 | BaseFare | Decimal | Base ticket fare excluding taxes and additional charges. | Mandatory |
| 5.9.16.3 | Tax | Decimal | Total applicable taxes. | Mandatory |
| 5.9.16.4 | YQTax | Decimal | Fuel surcharge imposed by the airline. | Mandatory |
| 5.9.16.5 | AdditionalTxnFeeOfrd | Decimal | Additional Transaction Fee Offered (It will always be zero) | Mandatory |
| 5.9.16.6 | AdditionalTxnFeePub | Decimal | Additional Transaction Fee Published | Mandatory |
| 5.9.16.7 | PGCharge | Decimal | Payment Gateway Charges | Mandatory |
| 5.9.16.8 | OtherCharges | Decimal | Additional miscellaneous charges. | Mandatory |
| 5.9.16.9 | PublishedFare | Decimal | Total fare published by the airline. | Mandatory |
| 5.9.16.10 | OfferedFare | Decimal | Final fare offered to the customer. | Mandatory |
| 5.9.16.11 | CommissionEarned | Decimal | Commission earned on the booking. | Mandatory |
| 5.9.16.12 | TdsOnCommission | Decimal | Tax deducted at source (TDS) on the commission amount. | Mandatory |
| 5.9.16.13 | ServiceFee | Decimal | Service fee charged for the booking. | Mandatory |
| 5.9.16.14 | TotalBaggageCharges | Decimal | Total charges for selected baggage services. | Mandatory |
| 5.9.16.15 | TotalMealCharges | Decimal | Total charges for selected meal services. | Mandatory |
| 5.9.16.16 | TotalSeatCharges | Decimal | Total charges for selected seats. | Mandatory |
| 5.9.16.17 | TotalSpecialServiceCharges | Decimal | Total charges for all selected special services (SSR). | Mandatory |
| 5.9.17 | CreditNoteCreatedOn | Date Time | Date and time when the credit note was generated. | Mandatory |
| 5.9.18 | Passenger[] | Array | List of passengers included in the booking. | Mandatory |
| 5.9.18.1 | PaxId | String | Unique identifier of the passenger. | Mandatory |
| 5.9.18.2 | Title | String | Passenger title (Mr, Mrs, Miss, etc.). | Mandatory |
| 5.9.18.3 | FirstName | String | Passenger's first name as per passport/ID. | Mandatory |
| 5.9.18.4 | LastName | String | Passenger's last name as per passport/ID. | Mandatory |
| 5.9.18.5 | PaxType | Integer | Passenger type (Adult, Child, Infant). | Mandatory |
| 5.9.18.6 | DateOfBirth | Date Time | Passenger's date of birth. | Mandatory |
| 5.9.18.7 | Gender | String | Passenger gender. | Mandatory |
| 5.9.18.8 | PassportNo | String | Passenger passport number. | Optional |
| 5.9.18.9 | AddressLine1 | String | Passenger address line 1. | Mandatory |
| 5.9.18.10 | City | String | Passenger city of residence. | Mandatory |
| 5.9.18.11 | CountryCode | String | ISO country code. | Mandatory |
| 5.9.18.12 | CountryName | String | Full country name. | Mandatory |
| 5.9.18.13 | Nationality | String | Passenger nationality. | Mandatory |
| 5.9.18.14 | ContactNo | String | Passenger contact number. | Mandatory |
| 5.9.18.15 | String | Passenger email address. | Mandatory | |
| 5.9.18.16 | IsLeadPax | Boolean | Indicates whether the passenger is the lead passenger for the booking. (Value – True or False) | Mandatory |
| 5.9.18.17 | FFAirlineCode | String | Frequent flyer airline code | Optional |
| 5.9.18.18 | FFNumber | String | Frequent flyer number | Optional |
| 5.9.18.19 | Fare{} | Object | Fare details applicable to the passenger. | Mandatory |
| 5.9.18.19.1 | Currency | String | Fare currency code. | Mandatory |
| 5.9.18.19.2 | BaseFare | Decimal | Base fare amount excluding taxes and charges. | Mandatory |
| 5.9.18.19.3 | Tax | Decimal | Total tax amount. | Mandatory |
| 5.9.18.19.4 | YQTax | Decimal | Airline fuel surcharge (YQ tax). | Mandatory |
| 5.9.18.19.5 | AdditionalTxnFeeOfrd | Decimal | Additional Transaction Fee Offered (It will always be zero) | Mandatory |
| 5.9.18.19.6 | AdditionalTxnFeePub | Decimal | Additional Transaction Fee Published | Mandatory |
| 5.9.18.19.7 | PGCharge | Decimal | Payment gateway charges. | Mandatory |
| 5.9.18.19.8 | OtherCharges | Decimal | Any additional charges applicable. | Mandatory |
| 5.9.18.19.9 | PublishedFare | Decimal | Published fare amount | Mandatory |
| 5.9.18.19.10 | OfferedFare | Decimal | Offered fare amount after discounts. | Mandatory |
| 5.9.18.19.11 | ServiceFee | Decimal | Service fee charged for the booking. | Mandatory |
| 5.9.18.19.12 | TotalBaggageCharges | Decimal | Total Baggage Charges | Mandatory |
| 5.9.18.19.13 | TotalMealCharges | Decimal | Total Meal Charges | Mandatory |
| 5.9.18.19.14 | TotalSeatCharges | Decimal | Total Seat Charges | Mandatory |
| 5.9.18.19.15 | TotalSpecialServiceCharges | Decimal | Total Special Service Charges | Mandatory |
| 5.9.19 | CancellationCharges | String | Cancellation Charges | Mandatory |
| 5.9.20 | Segments[] | array | Flight segment details. | Mandatory |
| 5.9.20.1 | Baggage | String | Baggage allowance for the segment. | Mandatory |
| 5.9.20.2 | CabinBaggage | String | Cabin/hand baggage allowance permitted onboard. | Mandatory |
| 5.9.20.3 | TripIndicator | String | Indicates trip sequence/order. | Mandatory |
| 5.9.20.4 | SegmentIndicator | Integer | Indicates segment sequence/order. | Mandatory |
| 5.9.20.5 | DepTime | DateTime | Flight departure date and time. | Mandatory |
| 5.9.20.6 | ArrTime | Time | Flight arrival date and time | Mandatory |
| 5.9.20.7 | Airline{} | Object | Airline operating the segment. | Mandatory |
| 5.9.20.7.1 | AirlineCode | String | Airline IATA code. | Mandatory |
| 5.9.20.7.2 | AirlineName | String | Airline name | Mandatory |
| 5.9.20.7.3 | FlightNumber | String | Flight Number | Mandatory |
| 5.9.20.7.4 | FareClass | String | Fare class or booking class. | Mandatory |
| 5.9.20.7.5 | OperatingCarrier | String | Operating Carrier Code | Mandatory |
| 5.9.20.8 | AirlinePNR | String | Airline reservation reference (PNR). | Optional |
| 5.9.20.9 | AccumulatedDuration | Time | Total accumulated travel duration. | Optional |
| 5.9.20.10 | Origin{} | Object | Origin airport details. | Mandatory |
| 5.9.20.10.1 | AirportCode | String | Airport IATA code. | Mandatory |
| 5.9.20.10.2 | AirportName | String | Airport Name | Mandatory |
| 5.9.20.10.3 | Terminal | String | Terminal from which the flight departs or arrives. | Optional |
| 5.9.20.10.4 | CityCode | String | Standard code representing the city. | Mandatory |
| 5.9.20.10.5 | CityName | String | Name of the city | Mandatory |
| 5.9.20.10.6 | CountryCode | String | ISO country code of the airport location. | Mandatory |
| 5.9.20.10.7 | CountryName | String | Name of the country where the airport is located. | Mandatory |
| 5.9.20.11 | Destination{} | Object | Arrival airport and location details. | Mandatory |
| 5.9.20.11.1 | AirportCode | String | IATA airport code (e.g., DEL, BOM, JFK). | Mandatory |
| 5.9.20.11.2 | AirportName | String | Full name of the airport. | Mandatory |
| 5.9.20.11.3 | Terminal | String | Terminal from which the flight departs or arrives. | Optional |
| 5.9.20.11.4 | CityCode | String | Standard code representing the city. | Mandatory |
| 5.9.20.11.5 | CityName | String | Name of the city. | Mandatory |
| 5.9.20.11.6 | CountryCode | String | ISO country code of the airport location. | Mandatory |
| 5.9.20.11.7 | CountryName | String | Name of the country where the airport is located. | Mandatory |
| 5.9.20.12 | Duration | Time | Total flight duration for the segment. | Optional |
| 5.9.20.13 | GroundTime | Time | Layover duration before the next connecting flight. | Optional |
| 5.9.20.14 | Mile | String | Distance covered by the flight segment in miles. | Optional |
| 5.9.20.15 | StopOver | String | Indicates whether the flight includes a stopover. | Optional |
| 5.9.20.16 | StopPoint | String | Airport or city where the stopover occurs. | Optional |
| 5.9.20.17 | StopPointArrivalTime | Date Time | Arrival date and time at the stopover location. | Optional |
| 5.9.20.18 | StopPointDepartureTime | Date Time | Departure date and time from the stopover location. | Optional |
| 5.9.20.19 | Craft | String | Aircraft type used for the flight segment. | Optional |
| 5.9.20.20 | Remark | String | Additional information or notes related to the flight. | Optional |
| 5.9.20.21 | IsETicketEligible | Boolean | Indicates whether electronic ticketing is supported.(Value – true or false) | Mandatory |
| 5.9.20.22 | FlightStatus | String | Current operational status of the flight (Scheduled, Delayed, Cancelled, etc.). | Mandatory |
| 5.9.20.23 | Status | String | Availability or booking status of the flight segment. | Mandatory |
| 5.9.21 | FareRules[] | Array | Applicable fare rules. | Mandatory |
| 5.9.21.1 | Origin | String | Origin airport and location details. | Mandatory |
| 5.9.21.2 | Destination | String | Departure airport and location details. | Mandatory |
| 5.9.21.3 | Airline | String | IATA airline code or airline name to which the fare rule applies. | Mandatory |
| 5.9.21.4 | FareBasisCode | String | Airline-defined fare basis code identifying the specific fare type, booking class, and fare conditions associated with the ticket | Mandatory |
| 5.9.21.5 | FareRuleDetail | String | Detailed fare conditions provided by the airline, including cancellation policies, rescheduling charges, refund eligibility, no-show penalties, baggage rules, and other applicable restrictions. | Mandatory |
| 5.9.21.6 | FareRestriction | String | Fare restrictions and applicable conditions. | Mandatory |