Cyberesa Developers V2027.0.x
Hotel API · Reservations & credit

BookingList()

This function is dedicated to retrieve the bookings for a given hotel. Uses idtoken if exist, or idorder if exist or return all bookings starting from lastupdate date or between fromdate / todate.

Request

XML
<BookingListRQ>
  <Credential>
    <Login>?</Login>
    <Password>?</Password>
  </Credential>
  <User>?</User>
  <Ilng>?</Ilng>
  <Source>?</Source>
  <hotel>?</hotel>
  <idtoken>?</idtoken>
  <idorder>?</idorder>
  <operation>?</operation>
  <lastupdate>?</lastupdate>
  <fromdate>?</fromdate>
  <todate>?</todate>
</BookingListRQ>
RootSub rootDescriptionValues & FormatTag
CredentialMandatory
LoginText
PasswordText
UserCurrent user IdNumericMandatory
IlngLanguage IdNumericOptional
SourceSource IdTextMandatory if hotel is through a 3rd party supplier
hotelHotel IdTextOptional
idtokenToken IdNumericOptional
idorderId of orderNumericOptional
operationtype of operationText“pms” in case of connection from a hotel PMS software
lastupdatelast updatedateOptional
fromdatebooking from datedateOptional
todatebooking to datedateOptional

Response

XML
<BookingListRS>
  <ErrorResult id="?">
    <message>?</message>
  </ErrorResult>
  <bookings>
    <booking>
      <id>?</id>
  <ClientTel>?</ClientTel>
  <ClientEmail>?</ClientEmail>
  <Autorisation>?</Autorisation>
  <PaidAmount>?</PaidAmount>
      <totalnetRate>?</totalnetRate>
      <totalPaidAmount>?</totalPaidAmount>
      <idaffiliate>?</idaffiliate>
      <city>?</city>
      <hoteltitle> ?</hoteltitle>
      <fromdate> ?</fromdate>
      <todate> ?</todate>
      <remarks> ?</remarks>
      <lastupdate> ?</lastupdate>
      <state id="?"> ?</state>
      <Source>?</Source>
      <HCN>?</HCN>
      <rooms>
        <room>
          <type> ?</type>
          <boarding> ?</boarding>
          <netRate> ?</netRate>
          <Supplements/>
          <customers>
            <customer>
              <name> ?</name>
              <reductions> ?</reductions>
              <kind> ?</kind>
            </customer>
          </customers>
        </room>
      </rooms>
    </booking>
  </bookings>
  <Started>
  </Started>
  <ResponseTime>
  </ResponseTime>
</BookingListRS>
RootSub rootDescriptionValues & FormatTag
ErrorResultOperation State
ErrorResult:@idId of current errorNumeric
messageAppropriate messageText
bookings
totalnetRatecost rateNumeric
totalPaidAmountpaid amount (added when state is reserved and booking is paid online)Numeric
idaffiliateId Affiliate (agent)Numeric
ClientTelClient phone numberText
ClientEmailClient EmailText
AutorisationAuthorisationNumeric
PaidAmountPaid AmountNumeric
cityHotel city locationtext
hoteltitleTitletext
fromdateDate reservation fromDate
todateDate reservation toDate
remarksRemarksText
lastupdateLast update dateDate
SourceSource IdText
HCNHotel confirmation numberText
stateState of the reservationText
State : @idId of the state of the reservationNumeric4 : The hotel is available and your booking is confirmed, a voucher is issued
1 : The hotel is available and your booking is confirmed as reserved, no voucher is issued
0 : the hotel is not available is your booking is saved as onrequest
2 : the booking is cancelled
9: the booking OnRequest accepted by the hotel and saved as OnRequestOK
rooms
typeType roomNumeric
boardingBoarding roomNumeric
netRateNet rate per roomNumeric
customers
nameCustomer NameText
reductionsReductionNumeric0 if no reduction is applied
kindkindtext
CYBERESA SARL au capital de 560 000 TND (R.C : B2437152011 – M.F : 1189611/V) Siège social : Immeuble 3S, Lotissement Ennassim, 1073 Montplaisir - Tunis - TUNISIE · Tél : +216 71 947 401 - Fax : +216 70 201 010 - Site web : www.cyberesa.net - Email : info@cyberesa.net
© Cyberesa · Hotel API V2027.0.x · updated 09/10/2026