> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://wt.hhr.systems/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://wt.hhr.systems/_mcp/server. # Search trains and fares POST https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ Content-Type: application/json Search for trains and fares, one way or round trip. Add a second entry to `originDestinationInformation` for the return leg. Fares are dynamic, so always price against a fresh search. Set `availableFlightsOnly` to `false` to also see sold-out classes; a class with `resBookDesigQuantity` of `0` (or status other than `A`) is sold out. Reference: https://wt.hhr.systems/hhr-ticketing-system-api/search/low-fare-search ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /ota/v2015b/OTA#OTA_AirLowFareSearchRQ: post: operationId: lowFareSearch summary: Search trains and fares description: > Search for trains and fares, one way or round trip. Add a second entry to `originDestinationInformation` for the return leg. Fares are dynamic, so always price against a fresh search. Set `availableFlightsOnly` to `false` to also see sold-out classes; a class with `resBookDesigQuantity` of `0` (or status other than `A`) is sold out. tags: - Search parameters: - name: x-api-key in: header required: true schema: type: string - name: local-name in: header description: Routes the request to the search operation. required: true schema: $ref: >- #/components/schemas/OtaV2015BOtaOtaAirLowFareSearchRqPostParametersLocalName responses: '200': description: Matching trains with dynamic fares by class. content: application/json: schema: $ref: '#/components/schemas/AirLowFareSearchResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/AirLowFareSearchRequest' servers: - url: https://api.sar.worldticket.cloud description: Production - url: https://test-api.worldticket.net description: Test components: schemas: OtaV2015BOtaOtaAirLowFareSearchRqPostParametersLocalName: type: string enum: - OTA_AirLowFareSearchRQ default: OTA_AirLowFareSearchRQ title: OtaV2015BOtaOtaAirLowFareSearchRqPostParametersLocalName RequestorID: type: object properties: id: type: string description: Agent identifier. name: type: string description: Agency name. type: type: string description: Requestor type. title: RequestorID BookingChannel: type: object properties: type: type: string title: BookingChannel Source: type: object properties: isocurrency: type: string description: ISO currency code. Always SAR. isoCurrency: type: string description: ISO currency code (used by the cancel operation). requestorID: $ref: '#/components/schemas/RequestorID' bookingChannel: $ref: '#/components/schemas/BookingChannel' title: Source Pos: type: object properties: source: type: array items: $ref: '#/components/schemas/Source' description: Point of sale. Identifies the agent and channel behind the request. title: Pos AirLowFareSearchRequestProcessingInfo: type: object properties: displayOrder: type: string availabilityIndicator: type: boolean title: AirLowFareSearchRequestProcessingInfo BookingClass: type: string enum: - 'Y' - C description: Booking class. Y is Economy (HHR class T), C is Business (HHR class P). title: BookingClass AirLowFareSearchRequestSpecificFlightInfoBookingClassPrefItems: type: object properties: resBookDesigCode: $ref: '#/components/schemas/BookingClass' title: AirLowFareSearchRequestSpecificFlightInfoBookingClassPrefItems AirLowFareSearchRequestSpecificFlightInfo: type: object properties: bookingClassPref: type: array items: $ref: >- #/components/schemas/AirLowFareSearchRequestSpecificFlightInfoBookingClassPrefItems title: AirLowFareSearchRequestSpecificFlightInfo PassengerTypeCode: type: string enum: - ADT - CHD - INF - CTC description: > Passenger type. ADT, CHD and INF map to HHR codes 1, 2 and 3. CTC marks the required contact passenger. title: PassengerTypeCode PassengerTypeQuantity: type: object properties: code: $ref: '#/components/schemas/PassengerTypeCode' quantity: type: integer title: PassengerTypeQuantity AirLowFareSearchRequestTravelerInfoSummaryAirTravelerAvailItems: type: object properties: passengerTypeQuantity: type: array items: $ref: '#/components/schemas/PassengerTypeQuantity' title: AirLowFareSearchRequestTravelerInfoSummaryAirTravelerAvailItems AirLowFareSearchRequestTravelerInfoSummary: type: object properties: airTravelerAvail: type: array items: $ref: >- #/components/schemas/AirLowFareSearchRequestTravelerInfoSummaryAirTravelerAvailItems title: AirLowFareSearchRequestTravelerInfoSummary StationCode: type: string enum: - JED - JXD - KCX - MKX - DMX description: HHR station code. title: StationCode Location: type: object properties: locationCode: $ref: '#/components/schemas/StationCode' title: Location AirLowFareSearchRequestOriginDestinationInformationItemsDepartureDateTime: type: object properties: value: type: string windowAfter: type: string windowBefore: type: string title: >- AirLowFareSearchRequestOriginDestinationInformationItemsDepartureDateTime AirLowFareSearchRequestOriginDestinationInformationItems: type: object properties: originLocation: $ref: '#/components/schemas/Location' destinationLocation: $ref: '#/components/schemas/Location' departureDateTime: $ref: >- #/components/schemas/AirLowFareSearchRequestOriginDestinationInformationItemsDepartureDateTime title: AirLowFareSearchRequestOriginDestinationInformationItems AirLowFareSearchRequest: type: object properties: pos: $ref: '#/components/schemas/Pos' version: type: string processingInfo: $ref: '#/components/schemas/AirLowFareSearchRequestProcessingInfo' specificFlightInfo: $ref: '#/components/schemas/AirLowFareSearchRequestSpecificFlightInfo' travelerInfoSummary: $ref: '#/components/schemas/AirLowFareSearchRequestTravelerInfoSummary' availableFlightsOnly: type: boolean description: > Set to false to also return sold-out classes. A class with resBookDesigQuantity 0 is sold out. originDestinationInformation: type: array items: $ref: >- #/components/schemas/AirLowFareSearchRequestOriginDestinationInformationItems description: One entry for one way, two for a round trip. required: - pos - version - originDestinationInformation title: AirLowFareSearchRequest AirLowFareSearchResponseSuccess: type: object properties: {} title: AirLowFareSearchResponseSuccess AirLowFareSearchResponsePricedItineraries: type: object properties: pricedItinerary: type: array items: type: object additionalProperties: description: Any type title: AirLowFareSearchResponsePricedItineraries AirLowFareSearchResponse: type: object properties: success: $ref: '#/components/schemas/AirLowFareSearchResponseSuccess' timeStamp: type: string pricedItineraries: $ref: '#/components/schemas/AirLowFareSearchResponsePricedItineraries' title: AirLowFareSearchResponse ``` ## Examples **Request** ```json { "pos": { "source": [ { "isocurrency": "SAR", "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" }, "bookingChannel": { "type": "OTA" } } ] }, "version": "2.001", "originDestinationInformation": [ { "originLocation": { "locationCode": "MKX" }, "destinationLocation": { "locationCode": "DMX" }, "departureDateTime": { "value": "2026-05-14", "windowAfter": "P0D", "windowBefore": "P0D" } } ], "processingInfo": { "displayOrder": "BY_PRICE_LOW_TO_HIGH", "availabilityIndicator": true }, "specificFlightInfo": { "bookingClassPref": [ { "resBookDesigCode": "Y" }, { "resBookDesigCode": "C" } ] }, "travelerInfoSummary": { "airTravelerAvail": [ { "passengerTypeQuantity": [ { "code": "ADT", "quantity": 1 }, { "code": "CHD", "quantity": 0 }, { "code": "INF", "quantity": 0 } ] } ] }, "availableFlightsOnly": false } ``` **Response** ```json { "success": {}, "timeStamp": "2026-05-01T09:12:04.512Z", "pricedItineraries": { "pricedItinerary": [ { "airItinerary": { "originDestinationOptions": { "originDestinationOption": [ { "flightSegment": [ { "arrivalAirport": { "locationCode": "DMX" }, "arrivalDateTime": "2026-05-14T10:25:00.000+03:00", "bookingClassAvails": [ { "bookingClassAvail": [ { "resBookDesigCode": "C", "resBookDesigQuantity": "77", "resBookDesigStatusCode": "A" } ] }, { "bookingClassAvail": [ { "resBookDesigCode": "Y", "resBookDesigQuantity": "179", "resBookDesigStatusCode": "A" } ] } ], "departureAirport": { "locationCode": "MKX" }, "departureDateTime": "2026-05-14T08:00:00.000+03:00", "flightNumber": "0080", "marketingAirline": { "code": "HHR" }, "operatingAirline": { "code": "HHR", "flightNumber": "0080" }, "resBookDesigCode": "Y", "rph": "1" } ], "rph": "1" } ] } }, "airItineraryPricingInfo": { "fareInfos": { "fareInfo": [ { "arrivalAirport": { "locationCode": "DMX" }, "departureAirport": { "locationCode": "MKX" }, "fareReference": [ { "value": "BELMOWM" } ], "filingAirline": { "value": "HHR" } } ] }, "itinTotalFare": [ { "baseFare": { "amount": 331, "currencyCode": "SAR" }, "taxes": { "amount": 49.65, "tax": [ { "amount": 49.65, "taxCode": "VAT" } ] }, "totalFare": { "amount": 380.65, "currencyCode": "SAR" } } ] }, "sequenceNumber": 1 } ] } } ``` **SDK Code** ```python import requests url = "https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ" payload = { "pos": { "source": [ { "isocurrency": "SAR", "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" }, "bookingChannel": { "type": "OTA" } } ] }, "version": "2.001", "originDestinationInformation": [ { "originLocation": { "locationCode": "MKX" }, "destinationLocation": { "locationCode": "DMX" }, "departureDateTime": { "value": "2026-05-14", "windowAfter": "P0D", "windowBefore": "P0D" } } ], "processingInfo": { "displayOrder": "BY_PRICE_LOW_TO_HIGH", "availabilityIndicator": True }, "specificFlightInfo": { "bookingClassPref": [{ "resBookDesigCode": "Y" }, { "resBookDesigCode": "C" }] }, "travelerInfoSummary": { "airTravelerAvail": [{ "passengerTypeQuantity": [ { "code": "ADT", "quantity": 1 }, { "code": "CHD", "quantity": 0 }, { "code": "INF", "quantity": 0 } ] }] }, "availableFlightsOnly": False } headers = { "local-name": "OTA_AirLowFareSearchRQ", "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ'; const options = { method: 'POST', headers: { 'local-name': 'OTA_AirLowFareSearchRQ', 'x-api-key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: '{"pos":{"source":[{"isocurrency":"SAR","requestorID":{"id":"AGENT001","name":"Sample Travel","type":"5"},"bookingChannel":{"type":"OTA"}}]},"version":"2.001","originDestinationInformation":[{"originLocation":{"locationCode":"MKX"},"destinationLocation":{"locationCode":"DMX"},"departureDateTime":{"value":"2026-05-14","windowAfter":"P0D","windowBefore":"P0D"}}],"processingInfo":{"displayOrder":"BY_PRICE_LOW_TO_HIGH","availabilityIndicator":true},"specificFlightInfo":{"bookingClassPref":[{"resBookDesigCode":"Y"},{"resBookDesigCode":"C"}]},"travelerInfoSummary":{"airTravelerAvail":[{"passengerTypeQuantity":[{"code":"ADT","quantity":1},{"code":"CHD","quantity":0},{"code":"INF","quantity":0}]}]},"availableFlightsOnly":false}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ" payload := strings.NewReader("{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"originDestinationInformation\": [\n {\n \"originLocation\": {\n \"locationCode\": \"MKX\"\n },\n \"destinationLocation\": {\n \"locationCode\": \"DMX\"\n },\n \"departureDateTime\": {\n \"value\": \"2026-05-14\",\n \"windowAfter\": \"P0D\",\n \"windowBefore\": \"P0D\"\n }\n }\n ],\n \"processingInfo\": {\n \"displayOrder\": \"BY_PRICE_LOW_TO_HIGH\",\n \"availabilityIndicator\": true\n },\n \"specificFlightInfo\": {\n \"bookingClassPref\": [\n {\n \"resBookDesigCode\": \"Y\"\n },\n {\n \"resBookDesigCode\": \"C\"\n }\n ]\n },\n \"travelerInfoSummary\": {\n \"airTravelerAvail\": [\n {\n \"passengerTypeQuantity\": [\n {\n \"code\": \"ADT\",\n \"quantity\": 1\n },\n {\n \"code\": \"CHD\",\n \"quantity\": 0\n },\n {\n \"code\": \"INF\",\n \"quantity\": 0\n }\n ]\n }\n ]\n },\n \"availableFlightsOnly\": false\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("local-name", "OTA_AirLowFareSearchRQ") req.Header.Add("x-api-key", "YOUR_API_KEY") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["local-name"] = 'OTA_AirLowFareSearchRQ' request["x-api-key"] = 'YOUR_API_KEY' request["Content-Type"] = 'application/json' request.body = "{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"originDestinationInformation\": [\n {\n \"originLocation\": {\n \"locationCode\": \"MKX\"\n },\n \"destinationLocation\": {\n \"locationCode\": \"DMX\"\n },\n \"departureDateTime\": {\n \"value\": \"2026-05-14\",\n \"windowAfter\": \"P0D\",\n \"windowBefore\": \"P0D\"\n }\n }\n ],\n \"processingInfo\": {\n \"displayOrder\": \"BY_PRICE_LOW_TO_HIGH\",\n \"availabilityIndicator\": true\n },\n \"specificFlightInfo\": {\n \"bookingClassPref\": [\n {\n \"resBookDesigCode\": \"Y\"\n },\n {\n \"resBookDesigCode\": \"C\"\n }\n ]\n },\n \"travelerInfoSummary\": {\n \"airTravelerAvail\": [\n {\n \"passengerTypeQuantity\": [\n {\n \"code\": \"ADT\",\n \"quantity\": 1\n },\n {\n \"code\": \"CHD\",\n \"quantity\": 0\n },\n {\n \"code\": \"INF\",\n \"quantity\": 0\n }\n ]\n }\n ]\n },\n \"availableFlightsOnly\": false\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ") .header("local-name", "OTA_AirLowFareSearchRQ") .header("x-api-key", "YOUR_API_KEY") .header("Content-Type", "application/json") .body("{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"originDestinationInformation\": [\n {\n \"originLocation\": {\n \"locationCode\": \"MKX\"\n },\n \"destinationLocation\": {\n \"locationCode\": \"DMX\"\n },\n \"departureDateTime\": {\n \"value\": \"2026-05-14\",\n \"windowAfter\": \"P0D\",\n \"windowBefore\": \"P0D\"\n }\n }\n ],\n \"processingInfo\": {\n \"displayOrder\": \"BY_PRICE_LOW_TO_HIGH\",\n \"availabilityIndicator\": true\n },\n \"specificFlightInfo\": {\n \"bookingClassPref\": [\n {\n \"resBookDesigCode\": \"Y\"\n },\n {\n \"resBookDesigCode\": \"C\"\n }\n ]\n },\n \"travelerInfoSummary\": {\n \"airTravelerAvail\": [\n {\n \"passengerTypeQuantity\": [\n {\n \"code\": \"ADT\",\n \"quantity\": 1\n },\n {\n \"code\": \"CHD\",\n \"quantity\": 0\n },\n {\n \"code\": \"INF\",\n \"quantity\": 0\n }\n ]\n }\n ]\n },\n \"availableFlightsOnly\": false\n}") .asString(); ``` ```php request('POST', 'https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ', [ 'body' => '{ "pos": { "source": [ { "isocurrency": "SAR", "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" }, "bookingChannel": { "type": "OTA" } } ] }, "version": "2.001", "originDestinationInformation": [ { "originLocation": { "locationCode": "MKX" }, "destinationLocation": { "locationCode": "DMX" }, "departureDateTime": { "value": "2026-05-14", "windowAfter": "P0D", "windowBefore": "P0D" } } ], "processingInfo": { "displayOrder": "BY_PRICE_LOW_TO_HIGH", "availabilityIndicator": true }, "specificFlightInfo": { "bookingClassPref": [ { "resBookDesigCode": "Y" }, { "resBookDesigCode": "C" } ] }, "travelerInfoSummary": { "airTravelerAvail": [ { "passengerTypeQuantity": [ { "code": "ADT", "quantity": 1 }, { "code": "CHD", "quantity": 0 }, { "code": "INF", "quantity": 0 } ] } ] }, "availableFlightsOnly": false }', 'headers' => [ 'Content-Type' => 'application/json', 'local-name' => 'OTA_AirLowFareSearchRQ', 'x-api-key' => 'YOUR_API_KEY', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ"); var request = new RestRequest(Method.POST); request.AddHeader("local-name", "OTA_AirLowFareSearchRQ"); request.AddHeader("x-api-key", "YOUR_API_KEY"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"originDestinationInformation\": [\n {\n \"originLocation\": {\n \"locationCode\": \"MKX\"\n },\n \"destinationLocation\": {\n \"locationCode\": \"DMX\"\n },\n \"departureDateTime\": {\n \"value\": \"2026-05-14\",\n \"windowAfter\": \"P0D\",\n \"windowBefore\": \"P0D\"\n }\n }\n ],\n \"processingInfo\": {\n \"displayOrder\": \"BY_PRICE_LOW_TO_HIGH\",\n \"availabilityIndicator\": true\n },\n \"specificFlightInfo\": {\n \"bookingClassPref\": [\n {\n \"resBookDesigCode\": \"Y\"\n },\n {\n \"resBookDesigCode\": \"C\"\n }\n ]\n },\n \"travelerInfoSummary\": {\n \"airTravelerAvail\": [\n {\n \"passengerTypeQuantity\": [\n {\n \"code\": \"ADT\",\n \"quantity\": 1\n },\n {\n \"code\": \"CHD\",\n \"quantity\": 0\n },\n {\n \"code\": \"INF\",\n \"quantity\": 0\n }\n ]\n }\n ]\n },\n \"availableFlightsOnly\": false\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "local-name": "OTA_AirLowFareSearchRQ", "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" ] let parameters = [ "pos": ["source": [ [ "isocurrency": "SAR", "requestorID": [ "id": "AGENT001", "name": "Sample Travel", "type": "5" ], "bookingChannel": ["type": "OTA"] ] ]], "version": "2.001", "originDestinationInformation": [ [ "originLocation": ["locationCode": "MKX"], "destinationLocation": ["locationCode": "DMX"], "departureDateTime": [ "value": "2026-05-14", "windowAfter": "P0D", "windowBefore": "P0D" ] ] ], "processingInfo": [ "displayOrder": "BY_PRICE_LOW_TO_HIGH", "availabilityIndicator": true ], "specificFlightInfo": ["bookingClassPref": [["resBookDesigCode": "Y"], ["resBookDesigCode": "C"]]], "travelerInfoSummary": ["airTravelerAvail": [["passengerTypeQuantity": [ [ "code": "ADT", "quantity": 1 ], [ "code": "CHD", "quantity": 0 ], [ "code": "INF", "quantity": 0 ] ]]]], "availableFlightsOnly": false ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```