Read a booking | SAR - Harmain Train

curl -X POST https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ \
     -H "local-name: OTA_ReadRQ" \
     -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",
  "readRequests": {
    "readRequest": [
      {
        "uniqueID": {
          "id": "N6G2NW",
          "type": "14"
        }
      }
    ]
  }
}'

{
  "success": {},
  "airReservation": {
    "airItinerary": {
      "originDestinationOptions": {
        "originDestinationOption": [
          {
            "flightSegment": [
              {
                "arrivalAirport": {
                  "locationCode": "MKX"
                },
                "arrivalDateTime": "2026-05-20T17:55:00.000+03:00",
                "departureAirport": {
                  "locationCode": "JXD"
                },
                "departureDateTime": "2026-05-20T17:21:00.000+03:00",
                "flightNumber": "0141",
                "marketingAirline": {
                  "code": "HHR"
                },
                "resBookDesigCode": "Y",
                "rph": "1"
              }
            ]
          }
        ]
      }
    },
    "bookingReferenceID": [
      {
        "companyName": {
          "code": "W1"
        },
        "id": "N6G2NW",
        "type": "14"
      },
      {
        "companyName": {
          "code": "HHR"
        },
        "id": "CB0255134",
        "type": "14"
      }
    ],
    "offer": {
      "status": "BOOKED"
    },
    "priceInfo": {
      "fareInfos": {
        "fareInfo": [
          {
            "ruleInfo": {
              "tpaextensions": {
                "confirmationTimeLimit": "2026-05-17T10:49:00Z",
                "updateTravellersTimeLimit": "2026-05-17T10:20:00Z"
              }
            }
          }
        ]
      }
    },
    "ticketing": [
      {
        "flightSegmentRefNumber": [
          "1"
        ],
        "ticketTimeLimit": "2026-05-17T14:03:09.000+03:00",
        "ticketType": "E_TICKET"
      }
    ]
  },
  "timeStamp": "2026-05-01T09:40:19.220Z",
  "version": 2.001
}

Read a booking by its W1 record locator. Send the locator in readRequest.uniqueID with type 14. Use this to check the current status and the time limits before you ticket or cancel.

Request

This endpoint expects an object.

posobjectRequired

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

versionstringRequired

readRequestsobjectRequired

Response

The full reservation.

successobject

airReservationmap from strings to any

timeStampstring

versiondouble

Headers

Request

Response