Search trains and fares | SAR - Harmain Train

curl -X POST https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_AirLowFareSearchRQ \
     -H "local-name: OTA_AirLowFareSearchRQ" \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "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
}'

{
  "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
      }
    ]
  }
}

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.

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.

Request

This endpoint expects an object.

posobjectRequired

Point of sale. Identifies the agent and channel behind the request.

versionstringRequired

originDestinationInformationlist of objectsRequired

One entry for one way, two for a round trip.

processingInfoobjectOptional

specificFlightInfoobjectOptional

travelerInfoSummaryobjectOptional

availableFlightsOnlybooleanOptional

Set to false to also return sold-out classes. A class with resBookDesigQuantity 0 is sold out.

Response

Matching trains with dynamic fares by class.

successobject

timeStampstring

pricedItinerariesobject

Headers

Request

Response