ETG API V3
Affiliate API
Post booking
Order Information

Order Information

https://api.worldota.net/api/b2b/v3/hotel/order/info/

Retrieving a created order’s information using the partner’s booking identifier.

This is relevant only for those reservations that were initially successfully created (order/status request returned a result.status key with an OK value). It is recommended to have a time gap between receiving the booking confirmation and requesting the order information, due to ETG internal synchronization processes.

Request example 

curl --location 'https://api.worldota.net/api/b2b/v3/hotel/order/info/' \
--header 'Content-Type: application/json' \
--data '{
  "ordering": {
    "ordering_type": "desc",
    "ordering_by": "created_at"
  },
  "pagination": {
    "page_size": "10",
    "page_number": "1"
  }, 
  "search": {
    "created_at": {
      "from_date": "2018-12-05T00:00"
    }
  },
  "language":"en"
}'

Request body

ordering Object required

Arrangement in a sequence.

ordering_type String required

The ascending or descending ordering type.

ℹ️
  • The possible values:
    • asc.
    • desc.
ordering_by String required

Ordering parameter.

ℹ️
  • The possible values:
    • cancelled_at.
    • checkin_at.
    • checkout_at.
    • created_at.
    • free_cancellation_before.
    • modified_at.
    • payment_due.
    • payment_pending.
pagination Object required

Dividing order groups into discrete pages.

page_number Int required

The page number.

ℹ️
  • The minimum value is 1.
page_size Int required

The entity number per page.

ℹ️
  • The minimum value is 1.
  • The maximum value is 50.
search Object optional

Searching for something.

cancelled_at Object optional

Date and time of cancellation.

from_date String optional
The option to search greater than or equal to the value.
to_date String optional
The option to search less than or equal to the value.
checkin_at Object optional

Date of check-in.

from_date String optional
The option to search greater than or equal to the value.
to_date String optional
The option to search less than or equal to the value.
checkout_at Object optional

Date of check-out.

from_date String optional
The option to search greater than or equal to the value.
to_date String optional
The option to search less than or equal to the value.
created_at Object optional

The date and time of the order group creation.

from_date String optional
The option to search greater than or equal to the value.
to_date String optional
The option to search less than or equal to the value.
free_cancellation_before Object optional

Date and time of free cancellation.

from_date String optional
The option to search greater than or equal to the value.
to_date String optional
The option to search less than or equal to the value.
partner_order_ids [Int] optional
Identifiers of the bookings made by the partner (identifier created at Emerging Travel Group).
partner_order_ids [String] optional
The partner’s unique booking identifier.
status String required

Status of the reservation.

ℹ️
  • The possible values:
    • cancelled.
    • completed.
    • failed.
    • noshow.
    • prepending.
    • rejected.
modified_at Object optional

Date and time of modifying.

from_date String optional
The option to search greater than or equal to the value.
to_date String optional
The option to search less than or equal to the value.
source String optional

Source from which a booking has been made.

ℹ️
  • The possible values:
    • b2b-site.
    • b2b-api.
    • b2b-card.
    • b2b-handmade.
    • b2b-mobile-app-andr.
    • b2b-mobile-app-ios.

Response

current_page_number Int required
Number of the current page.
total_orders Int required
Total number of all your orders.
total_pages Int required
Total number of pages (using the current pagination request).
found_orders Int required
Found Orders.
found_pages Int required
Found Pages.
orders Object required

Orders information.

agreement_number String optional
Contract’s agreement number.
amount_payable Object required

Amount of the order in case it has been completed.

Amount of the cancellation fee in case the order has been cancelled (not free of charge).

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
amount_payable Object optional

Amount of VAT of the order in case it has been completed.

Amount of VAT of the cancellation fee in case it has been cancelled (not free of charge).

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
amount_refunded Object optional

Refunded amount (if the order is cancelled).

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
amount_sell Object optional

Amount of the order.

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
amount_sell_b2b2c Object optional

Resale price for the client.

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
api_auth_key_id Int optional
API key id.
cancellation_info Object optional

Cancellation information of the reservation.

free_cancellation_before String optional

Date and time before which you could cancell the reservation free of charge.

Timezone is UTC+0.

May return null - no free cancellation.

policies String optional

Cancellation policies’ breakdown by time periods.

end_at String optional

Date when this particular cancellation policy expires.

Timezone is UTC+0.

null means all the time from start_at till check-in.

If start_at = end_at = null it means that this particular cancellation policy has no time restrictions / is in effect all the time.

penalty String optional

Penalty information.

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
amount_info Object optional

The cancellation information. Has the null value if the commission type has the net or gross value.

Has the object value if you:

  • Have a net commission model.
  • Have indicated a non-zero commission in your account.
amount_commission Number optional
The commission amount.
amount_gross Number optional
The gross amount.
amount_net Number optional
The net amount.
start_at String optional

Date when this particular cancellation policy takes effect.

Timezone is UTC+0.

null means that it is in effect till end_at.

If start_at = end_at = null it means that this particular cancellation policy has no time restrictions / is in effect all the time.

cancelled_at String optional
Date and time of the booking cancellation.
checkin_at String required
Date of check-in at the hotel.
checkout_at String required
Date of check-out from the hotel.
contract_slug String required
Contract slug in the Emerging Travel Group system.
created_at String required
Date and time of the booking’s completion.
deposit Object required

The deposit information of the order. Has a value if the rate payment_types.type field has the hotel value.

amount Number optional
The deposit amount.
currency_code String optional
The deposit amount currency code. Is the same as the charged (hotel) currency code.
is_refundable Boolean optional
Whether the deposit is refundable or not.
hotel_data Object required

Information about the hotel booked.

id String required or optional

The unique hotel identifier.

ℹ️
  • Either this field or the hid field is required.
hid Int required or optional

The most preferred hotel ID.

ℹ️
  • Either this field or the id field is required.
  • The maximum length is 7 characters.
order_id String optional
Hotel’s internal order confirmation.
is_cancellable Boolean required
Is Cancellable.
modified_at String optional
Date and time of the booking’s last modification.
nights Int required
Number of nights of stay.
order_id Int required

Identifier of the booking made by the partner (identifier created at Emerging Travel Group).

ℹ️
  • The minimum value is 1.
order_type String required

The order type.

ℹ️
  • The possible values:
    • avia.
    • car.
    • hotel.
    • railway.
    • transfer.
    • upsell.
partner_data String required

Partner’s unique booking identifier and booking comment.

order_comment String optional
Partner’s booking comment. These comments are not sent to the hotel and are not processed by the Emerging Travel Group Support Team. They are visible only to the partner itself. This parameter can be specified in the comment field during the Order Booking Finish step.
order_id Int optional

Identifier of the booking made by the partner (identifier created at Emerging Travel Group).

ℹ️
  • The minimum value is 1.
utm_term String optional
Utm term.
partner_extra_cookie String optional
Partner extra cookie.
roomnights Int required
Total number of nights of stay for all rooms.
rooms_data Array[Object] required

Information about the room and the guests.

bedding_name [String] required

Bed types.

There is a request which returns all available beds and definitions (bedding key):

https://api.worldota.net/api/b2b/v3/hotel/static/

guest_data String required

Type (adult / child), number of guests and names.

adults_number Int required
Number of adults.
children_number Int required
Number of children.
guests Array[Object] required

Name of guests.

first_name String optional
Guest’s first name (transliterated into English).
first_name_original String optional
Guest’s first name (in the original language sent in the booking request).
last_name String optional
Guest’s last name (transliterated into English).
last_name_original String optional
Guest’s last name (in the original language sent in the booking request).
is_child Boolean optional
Whether or not the guest is a child.
age Int optional
Child’s age.
meal_name String required

Meal type.

There is a request which returns all available meals and definitions (meals key):

https://api.worldota.net/api/b2b/v3/hotel/static/

room_idx Int required
Room identifier.
room_name String required
Room name.
source String required

Source from which the booking was made.

ℹ️
  • The minimum length is 1 character.
status String required

Status of the reservation.

ℹ️
  • The possible values:
    • cancelled.
    • completed.
    • failed.
    • noshow.
    • prepending.
    • rejected.
supplier_data Object required

Supplier’s booking information.

confirmation_id String optional
Confirmation ID.
name String optional
Booking supplier’s name.
order_id String optional
Supplier’s unique booking identifier.
taxes Array[Object] optional

Information about the taxes.

amount_tax Object optional

Amount of the tax.

amount Number optional
Amount.
currency_code String optional

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
is_included Boolean required
Whether or not the tax is included by the supplier.
name String required

Name of the tax.

There is a request which returns all available taxes and definitions (taxes key):

https://api.worldota.net/api/b2b/v3/hotel/static/

total_vat Object optional

Amount of VAT of the order in case it has been completed.

Amount of VAT of the cancellation fee in case it has been cancelled (not free of charge).

amount Number optional
Amount.
currency_code String optional

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
amount_payable_with_upsells Object required

Amount of the order with all upsells in case it has been completed.

Amount of the cancellation fee in case it has been cancelled (not free of charge).

amount Number required
Amount.
currency_code String required

The currency code in the ISO 4217 format.

ℹ️
  • The length is 3 characters.
  • The possible values:
    • AED.
    • AFN.
    • ALL.
    • AMD.
    • ANG.
    • AOA.
    • ARS.
    • AUD.
    • AWG.
    • AZN.
    • BAM.
    • BBD.
    • BDT.
    • BGN.
    • BHD.
    • BIF.
    • BMD.
    • BND.
    • BOB.
    • BOV.
    • BRL.
    • BSD.
    • BTN.
    • BWP.
    • BYR.
    • BYN.
    • BZD.
    • CAD.
    • CDF.
    • CHE.
    • CHF.
    • CHW.
    • CLF.
    • CLP.
    • CNY.
    • COP.
    • COU.
    • CRC.
    • CUC.
    • CUP.
    • CVE.
    • CZK.
    • DJF.
    • DKK.
    • DOP.
    • DZD.
    • EGP.
    • ERN.
    • ETB.
    • EUR.
    • FJD.
    • FKP.
    • GBP.
    • GEL.
    • GHS.
    • GIP.
    • GMD.
    • GNF.
    • GTQ.
    • GYD.
    • HKD.
    • HNL.
    • HRK.
    • HTG.
    • HUF.
    • IDR.
    • ILS.
    • INR.
    • IQD.
    • IRR.
    • ISK.
    • JMD.
    • JOD.
    • JPY.
    • KES.
    • KGS.
    • KHR.
    • KMF.
    • KPW.
    • KRW.
    • KWD.
    • KYD.
    • KZT.
    • LAK.
    • LBP.
    • LKR.
    • LRD.
    • LSL.
    • LTL.
    • LVL.
    • LYD.
    • MAD.
    • MDL.
    • MGA.
    • MKD.
    • MMK.
    • MNT.
    • MOP.
    • MRO.
    • MUR.
    • MVR.
    • MWK.
    • MXN.
    • MXV.
    • MYR.
    • MZN.
    • NAD.
    • NGN.
    • NIO.
    • NOK.
    • NPR.
    • NZD.
    • OMR.
    • PAB.
    • PEN.
    • PGK.
    • PHP.
    • PKR.
    • PLN.
    • PYG.
    • QAR.
    • RON.
    • RSD.
    • RUB.
    • RWF.
    • SAR.
    • SBD.
    • SCR.
    • SDG.
    • SEK.
    • SGD.
    • SHP.
    • SLL.
    • SOS.
    • SRD.
    • SSP.
    • STD.
    • SVC.
    • SYP.
    • SZL.
    • THB.
    • TJS.
    • TMT.
    • TND.
    • TOP.
    • TRY.
    • TTD.
    • TWD.
    • TZS.
    • UAH.
    • UGX.
    • USD.
    • USN.
    • USS.
    • UYI.
    • UYU.
    • UZS.
    • VEF.
    • VND.
    • VUV.
    • WST.
    • XAF.
    • XAG.
    • XAU.
    • XBA.
    • XBB.
    • XBC.
    • XBD.
    • XCD.
    • XDR.
    • XFU.
    • XOF.
    • XPD.
    • XPF.
    • XPT.
    • XSU.
    • XTS.
    • XUA.
    • YER.
    • ZAR.
    • ZMW.
    • ZWL.
loyalty_card_data String optional

AffHotelOrderLoyaltyCardData.

card_number String required
Card number.
loyalty_type String required
Loyalty type.
order_token String optional
Order Token.
payment_data Object required

Order payment information.

invoice_id Int optional
Identifier of the order group.
invoice_id_v2 String optional
Identifier of the order group v2.
paid_at String optional
Date of payment for the reservation.
payment_by String optional
Information about the person who pays for the reservation.
payment_due String optional
The deadline, in date format, after which the reservation payment becomes overdue (if it has not been received yet).
payment_pending String optional
Date from which Emerging Travel Group begins to wait for the payment and notify the partner about it.
payment_type String required
Order payment information.
user_data Object optional

User’s booking information.

credit_card_data String optional

AffHotelOrderCreditCardData.

brand String required
Brand.
last4 String required
Last4.
email String optional
User’s email.
phone String optional
User’s phone.
arrival_datetime String optional
The date and time at which the client plans to check into the hotel.
user_comment String optional
A comment that the user wrote when filling out the booking form.

Response example 

{
  "data": {
    "current_page_number": 1,
    "orders": [
      {
        "agreement_number": "B2B-12980/1",
        "amount_payable": {
          "amount": "92.73",
          "currency_code": "EUR"
        },
        "amount_payable_vat": {
          "amount": "0.00",
          "currency_code": "EUR"
        },
        "amount_refunded": {
          "amount": "0",
          "currency_code": "EUR"
        },
        "amount_sell": {
          "amount": "92.73",
          "currency_code": "EUR"
        },
        "amount_sell_b2b2c": {
          "amount": "200.00",
          "currency_code": "EUR"
        },
        "amount_sell_b2b2c_commission": {
          "amount": "16.00",
          "currency_code": "EUR"
        },
        "api_auth_key_id": 1304,
        "cancellation_info": {
          "free_cancellation_before": "2018-12-05T04:59:00",
          "policies": [
            {
              "end_at": "2018-12-05T04:59:00",
              "penalty": {
                "amount": "0",
                "amount_info": {
                  "amount_commission": "0",
                  "amount_gross": "0",
                  "amount_net": "0"
                },
                "currency_code": "EUR"
              },
              "start_at": null
            },
            {
              "end_at": "2018-12-06T00:00:00",
              "penalty": {
                "amount": "10",
                "amount_info": {
                  "amount_commission": "0.2",
                  "amount_gross": "2",
                  "amount_net": "1.8"
                },
                "currency_code": "EUR"
              },
              "start_at": "2018-12-05T04:59:00"
            },
            {
              "end_at": null,
              "penalty": {
                "amount": "92.73",
                "currency_code": "EUR"
              },
              "start_at": "2018-12-06T00:00:00"
            }
          ]
        },
        "cancelled_at": null,
        "checkin_at": "2018-12-06",
        "checkout_at": "2018-12-17",
        "contract_slug": "test.b2b.1234",
        "created_at": "2018-11-27T10:44:48",
        "has_tickets": true,
        "hotel_data": {
          "id": "test_hotel",
          "order_id": null
        },
        "invoice_id": "12980-00257",
        "is_checked": true,
        "meta_data": {
          "voucher_order_comment": null
        },
        "modified_at": "2018-12-17T01:58:58",
        "nights": 11,
        "order_id": 538397516,
        "order_type": "hotel",
        "partner_data": {
          "order_comment": "partner_comment",
          "order_id": "upsellprod1"
        },
        "payment_data": {
          "invoice_id": 548878,
          "paid_at": "2018-11-29",
          "payment_by": null,
          "payment_due": "2018-12-05",
          "payment_pending": "2018-11-27",
          "payment_type": "deposit"
        },
        "roomnights": 11,
        "rooms_data": [
          {
            "bedding_name": [
              "nobedding"
            ],
            "guest_data": {
              "adults_number": 2,
              "children_number": 0,
              "guests": [
                {
                  "age": null,
                  "first_name": "Sema",
                  "first_name_original": "Сёма",
                  "is_child": false,
                  "last_name": "Johnson",
                  "last_name_original": "Джонсон"
                }
              ]
            },
            "meal_name": "nomeal",
            "room_idx": 0,
            "room_name": "Superior Double Room (Double bed)"
          }
        ],
        "source": "b2b-api",
        "status": "completed",
        "supplier_data": {
          "name": "Extranet",
          "order_id": "387278334"
        },
        "taxes": [
          {
            "amount_tax": {
              "amount": "17.12",
              "currency_code": "EUR"
            },
            "is_included": true,
            "name": "vat"
          }
        ],
        "upsells": [
          {
            "amount_payable": {
              "amount": "4.55",
              "currency_code": "EUR"
            },
            "amount_payable_vat": {
              "amount": "0",
              "currency_code": "EUR"
            },
            "amount_refunded": {
              "amount": "0.00",
              "currency_code": "EUR"
            },
            "amount_sell": {
              "amount": "4.55",
              "currency_code": "EUR"
            },
            "amount_sell_b2b2c": {
              "amount": "6.00",
              "currency_code": "EUR"
            },
            "cancelled_at": null,
            "created_at": "2018-11-27T11:24:00",
            "free_cancellation_before": "2018-12-05T04:59:00",
            "info": {
              "checkout_time": null
            },
            "order_id": 725262997,
            "order_type": "upsell",
            "payment_data": {
              "invoice_id": 548878,
              "paid_at": "2018-11-29",
              "payment_by": null,
              "payment_due": "2018-12-05",
              "payment_pending": "2018-11-27",
              "payment_type": "deposit"
            },
            "status": "completed",
            "type": "late_checkout"
          },
          {
            "amount_payable": {
              "amount": "3.55",
              "currency_code": "EUR"
            },
            "amount_payable_vat": {
              "amount": "0",
              "currency_code": "EUR"
            },
            "amount_refunded": {
              "amount": "1.00",
              "currency_code": "EUR"
            },
            "amount_sell": {
              "amount": "4.55",
              "currency_code": "EUR"
            },
            "amount_sell_b2b2c": {
              "amount": "4.00",
              "currency_code": "EUR"
            },
            "cancelled_at": null,
            "created_at": "2018-11-27T11:24:00",
            "deposit": {
              "amount": "135.00",
              "currency_code": "EUR",
              "is_refundable": false
            },
            "free_cancellation_before": "2018-12-05T04:59:00",
            "info": {
              "checkin_time": "2018-12-17T00:00:00Z"
            },
            "order_id": 609368724,
            "order_type": "upsell",
            "payment_data": {
              "invoice_id": 548300,
              "paid_at": "2018-11-27",
              "payment_by": null,
              "payment_due": "2018-12-05",
              "payment_pending": "2018-11-27",
              "payment_type": "deposit"
            },
            "status": "cancelled",
            "type": "early_checkin"
          }
        ],
        "user_data": {
          "email": "[email protected]"
        }
      }
    ],
    "total_orders": 1,
    "total_pages": 1
  },
  "debug": null,
  "error": null,
  "status": "ok"
}

Errors’ description

page_out_of_range

In case you request a higher page than you have

Order Cancellation