# Retrieve rate info

URL: https://docs.emergingtravel.com/docs/b2b-api/hotel-search/retrieve-rate-info/

Tags: b2b

---



**Sandbox**

```
https://api-sandbox.worldota.net/api/b2b/v3/search/lookuprate/
```

**Production**

```
https://api.worldota.net/api/b2b/v3/search/lookuprate/
```




The call gets one hotel rate. The response format is as in the [Retrieve hotelpage](/docs/b2b-api/hotel-search/retrieve-hotelpage/) call.

> [!WARNING]
> To have permission to the call with your API key, contact the API support team.



## Sandbox limitations { #limitations }

> [!WARNING]
> Use only field values, IDs, API keys, and any static content from the sandbox environment within the sandbox. <strong>Do not use sandbox data in test or production environments, and do not mix data or configuration between different environments.</strong>




* The input value for the `language` field is ignored; it is always set to `en`.
* The following fields are not supported:
  * `hotels.rates.payment_options.payment_types.cancellation_penalties.policies.commission_info.charge.amount_gross`
  * `hotels.rates.payment_options.payment_types.cancellation_penalties.policies.commission_info.charge.amount_commission`
* For all objects containing the `currency_code` field, its value is always set to `USD`.

## Request example


**Sandbox**

```shell
curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.worldota.net/api/b2b/v3/search/lookuprate/' \
--header 'Content-Type: application/json' \
--data '{
  "book_hash": "h-7e16d7a9-fe3c-5ba0-8aa1-0ea5b851afe7",
  "language": "en"
}'
```

**Production**

```shell
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/b2b/v3/search/lookuprate/' \
--header 'Content-Type: application/json' \
--data '{
  "book_hash": "h-7e16d7a9-fe3c-5ba0-8aa1-0ea5b851afe7",
  "language": "en"
}'
```




## Request body



- **book_hash** *(String, required)*

  <p>The unique rate ID used to identify the selected rate.</p>
  > [!NOTE]
  > Use the value of the `book_hash` field from one of the calls:
  >   * [Prebook rate from hotelpage step](/docs/b2b-api/hotel-search/prebook-rate-from-hotelpage-step/).
  >   * [Prebook rate from search step](/docs/b2b-api/hotel-search/prebook-rate-from-search-step/).


- **language** *(String, optional)*

  <p>The hotel data language.</p>
  > [!NOTE]
  > * The default value is the contract language.
  > * The possible values:
  >   * `ar` — Arabic.
  >   * `bg` — Bulgarian.
  >   * `cs` — Czech.
  >   * `da` — Danish.
  >   * `de` — German.
  >   * `el` — Greek.
  >   * `en` — English.
  >   * `es` — Spanish.
  >   * `fi` — Finnish.
  >   * `fr` — French.
  >   * `he` — Hebrew.
  >   * `hu` — Hungarian.
  >   * `it` — Italian.
  >   * `ja` — Japanese.
  >   * `kk` — Kazakh.
  >   * `ko` — Korean.
  >   * `nl` — Dutch.
  >   * `no` — Norwegian.
  >   * `pl` — Polish.
  >   * `pt` — Portuguese.
  >   * `pt_PT` — Portuguese (Portugal).
  >   * `ro` — Romanian.
  >   * `ru` — Russian.
  >   * `sq` — Albanian.
  >   * `sr` — Serbian.
  >   * `sv` — Swedish.
  >   * `th` — Thai.
  >   * `tr` — Turkish.
  >   * `uk` — Ukrainian.
  >   * `vi` — Vietnamese.
  >   * `zh_CN` — Simplified Chinese.
  >   * `zh_TW` — Traditional Chinese.





## Response



[//]: # (original_request_params)
- **original_request_params** *([Object])*

  <p>Information about the request body from the [Retrieve hotelpage](/docs/b2b-api/hotel-search/retrieve-hotelpage/)
  
  call.</p>
  <ul>
  <li>
  <p><strong>checkin</strong> <em>(String)</em></p>
  <p>The check-in date. The value must be not later than 730 days from the day when the request is made.</p>
  </li>
  <li>
  <p><strong>checkout</strong> <em>(String)</em></p>
  <p>The check-out date. The value must be not later than 30 days from the checkin field value.</p>
  </li>
  <li>
  <p><strong>residency</strong> <em>(String)</em></p>
  <p>The guests’ citizenship in the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
   format.</p>
  <p>Use this field if there are doubts regarding the country or the hotel policy towards citizens.</p>
  > [!NOTE]
  > The possible values:
  > * `ad` — Andorra.
  > * `ae` — United Arab Emirates.
  > * `af` — Afghanistan.
  > * `ag` — Antigua and Barbuda.
  > * `ai` — Anguilla.
  > * `al` — Albania.
  > * `am` — Armenia.
  > * `ao` — Angola.
  > * `aq` — Antarctica.
  > * `ar` — Argentina.
  > * `as` — American Samoa.
  > * `at` — Austria.
  > * `au` — Australia.
  > * `aw` — Aruba.
  > * `ax` — Åland Islands.
  > * `az` — Azerbaijan.
  > * `ba` — Bosnia and Herzegovina.
  > * `bb` — Barbados.
  > * `bd` — Bangladesh.
  > * `be` — Belgium.
  > * `bf` — Burkina Faso.
  > * `bg` — Bulgaria.
  > * `bh` — Bahrain.
  > * `bi` — Burundi.
  > * `bj` — Benin.
  > * `bl` — Saint Barthélemy.
  > * `bm` — Bermuda.
  > * `bn` — Brunei Darussalam.
  > * `bo` — Bolivia.
  > * `bq` — Bonaire, Sint Eustatius and Saba.
  > * `br` — Brazil.
  > * `bs` — Bahamas.
  > * `bt` — Bhutan.
  > * `bv` — Bouvet Island.
  > * `bw` — Botswana.
  > * `by` — Belarus.
  > * `bz` — Belize.
  > * `ca` — Canada.
  > * `cc` — Cocos (Keeling) Islands.
  > * `cd` — Democratic Republic of the Congo, also known as Congo-Kinshasa.
  > * `cf` — Central African Republic.
  > * `cg` — The Republic of the Congo, also known as Congo-Brazzaville.
  > * `ch` — Switzerland.
  > * `ci` — Côte d'Ivoire.
  > * `ck` — Cook Islands.
  > * `cl` — Chile.
  > * `cm` — Cameroon.
  > * `cn` — China.
  > * `co` — Colombia.
  > * `cr` — Costa Rica.
  > * `cu` — Cuba.
  > * `cv` — Cabo Verde.
  > * `cw` — Curaçao.
  > * `cx` — Christmas Island.
  > * `cy` — Cyprus.
  > * `cz` — Czechia.
  > * `de` — Germany.
  > * `dj` — Djibouti.
  > * `dk` — Denmark.
  > * `dm` — Dominica.
  > * `do` — Dominican Republic.
  > * `dz` — Algeria.
  > * `ec` — Ecuador.
  > * `ee` — Estonia.
  > * `eg` — Egypt.
  > * `eh` — Western Sahara.
  > * `er` — Eritrea.
  > * `es` — Spain.
  > * `et` — Ethiopia.
  > * `fi` — Finland.
  > * `fj` — Fiji.
  > * `fk` — Falkland Islands (Malvinas).
  > * `fm` — Micronesia.
  > * `fo` — Faroe Islands.
  > * `fr` — France.
  > * `ga` — Gabon.
  > * `gb` — United Kingdom of Great Britain and Northern Ireland.
  > * `gd` — Grenada.
  > * `ge` — Georgia.
  > * `gf` — French Guiana.
  > * `gg` — Guernsey.
  > * `gh` — Ghana.
  > * `gi` — Gibraltar.
  > * `gl` — Greenland.
  > * `gm` — Gambia.
  > * `gn` — Guinea.
  > * `gp` — Guadeloupe.
  > * `gq` — Equatorial Guinea.
  > * `gr` — Greece.
  > * `gs` — South Georgia and the South Sandwich Islands.
  > * `gt` — Guatemala.
  > * `gu` — Guam.
  > * `gw` — Guinea-Bissau.
  > * `gy` — Guyana.
  > * `hk` — Hong Kong.
  > * `hm` — Heard Island and McDonald Islands.
  > * `hn` — Honduras.
  > * `hr` — Croatia.
  > * `ht` — Haiti.
  > * `hu` — Hungary.
  > * `id` — Indonesia.
  > * `ie` — Ireland.
  > * `il` — Israel.
  > * `im` — Isle of Man.
  > * `in` — India.
  > * `io` — British Indian Ocean Territory.
  > * `iq` — Iraq.
  > * `ir` — Iran.
  > * `is` — Iceland.
  > * `it` — Italy.
  > * `je` — Bailiwick of Jersey.
  > * `jm` — Jamaica.
  > * `jo` — Jordan.
  > * `jp` — Japan.
  > * `ke` — Kenya.
  > * `kg` — Kyrgyzstan.
  > * `kh` — Cambodia.
  > * `ki` — Kiribati.
  > * `km` — Comoros.
  > * `kn` — Saint Kitts and Nevis.
  > * `kp` — North Korea.
  > * `kr` — South Korea.
  > * `kw` — Kuwait.
  > * `ky` — Cayman Islands.
  > * `kz` — Kazakhstan.
  > * `la` — Laos.
  > * `lb` — Lebanon.
  > * `lc` — Saint Lucia.
  > * `li` — Liechtenstein.
  > * `lk` — Sri Lanka.
  > * `lr` — Liberia.
  > * `ls` — Lesotho.
  > * `lt` — Lithuania.
  > * `lu` — Luxembourg.
  > * `lv` — Latvia.
  > * `ly` — Libya.
  > * `ma` — Morocco.
  > * `mc` — Monaco.
  > * `md` — Moldova.
  > * `me` — Montenegro.
  > * `mf` — Saint Martin.
  > * `mg` — Madagascar.
  > * `mh` — Marshall Islands.
  > * `mk` — North Macedonia.
  > * `ml` — Mali.
  > * `mm` — Myanmar.
  > * `mn` — Mongolia.
  > * `mo` — Macao.
  > * `mp` — Northern Mariana Islands.
  > * `mq` — Martinique.
  > * `mr` — Mauritania.
  > * `ms` — Montserrat.
  > * `mt` — Malta.
  > * `mu` — Mauritius.
  > * `mv` — Maldives.
  > * `mw` — Malawi.
  > * `mx` — Mexico.
  > * `my` — Malaysia.
  > * `mz` — Mozambique.
  > * `na` — Namibia.
  > * `nc` — New Caledonia.
  > * `ne` — Niger.
  > * `nf` — Norfolk Island.
  > * `ng` — Nigeria.
  > * `ni` — Nicaragua.
  > * `nl` — Netherlands.
  > * `no` — Norway.
  > * `np` — Nepal.
  > * `nr` — Nauru.
  > * `nu` — Niue.
  > * `nz` — New Zealand.
  > * `om` — Oman.
  > * `pa` — Panama.
  > * `pe` — Peru.
  > * `pf` — French Polynesia.
  > * `pg` — Papua New Guinea.
  > * `ph` — Philippines.
  > * `pk` — Pakistan.
  > * `pl` — Poland.
  > * `pm` — Saint Pierre and Miquelon.
  > * `pn` — Pitcairn.
  > * `pr` — Puerto Rico.
  > * `ps` — Palestine.
  > * `pt` — Portugal.
  > * `pw` — Palau.
  > * `py` — Paraguay.
  > * `qa` — Qatar.
  > * `re` — Réunion.
  > * `ro` — Romania.
  > * `rs` — Serbia.
  > * `ru` — Russian Federation.
  > * `rw` — Rwanda.
  > * `sa` — Saudi Arabia.
  > * `sb` — Solomon Islands.
  > * `sc` — Seychelles.
  > * `sd` — Sudan.
  > * `se` — Sweden.
  > * `sg` — Singapore.
  > * `sh` — Saint Helena, Ascension and Tristan da Cunha.
  > * `si` — Slovenia.
  > * `sj` — Svalbard and Jan Mayen.
  > * `sk` — Slovakia.
  > * `sl` — Sierra Leone.
  > * `sm` — San Marino.
  > * `sn` — Senegal.
  > * `so` — Somalia.
  > * `sr` — Suriname.
  > * `ss` — South Sudan.
  > * `st` — Sao Tome and Principe.
  > * `sv` — El Salvador.
  > * `sx` — Sint Maarten.
  > * `sy` — Syrian Arab Republic.
  > * `sz` — Eswatini.
  > * `tc` — Turks and Caicos Islands.
  > * `td` — Chad.
  > * `tf` — French Southern Territories.
  > * `tg` — Togo.
  > * `th` — Thailand.
  > * `tj` — Tajikistan.
  > * `tk` — Tokelau.
  > * `tl` — Timor-Leste.
  > * `tm` — Turkmenistan.
  > * `tn` — Tunisia.
  > * `to` — Tonga.
  > * `tr` — Turkey.
  > * `tt` — Trinidad and Tobago.
  > * `tv` — Tuvalu.
  > * `tw` — Taiwan.
  > * `tz` — Tanzania.
  > * `ua` — Ukraine.
  > * `ug` — Uganda.
  > * `um` — United States Minor Outlying Islands.
  > * `us` — United States of America.
  > * `uy` — Uruguay.
  > * `uz` — Uzbekistan.
  > * `va` — Holy See.
  > * `vc` — Saint Vincent and the Grenadines.
  > * `ve` — Venezuela.
  > * `vg` — Virgin Islands (British).
  > * `vi` — Virgin Islands (U.S.).
  > * `vn` — Vietnam.
  > * `vu` — Vanuatu.
  > * `wf` — Wallis and Futuna.
  > * `ws` — Samoa.
  > * `xk` — Kosovo.
  > * `ye` — Yemen.
  > * `yt` — Mayotte.
  > * `za` — South Africa.
  > * `zm` — Zambia.
  > * `zw` — Zimbabwe.
  </li>
  <li>
  <p><strong>guests</strong> <em>([Object])</em></p>
  <p>The list of guests in the rooms.</p>
  > [!NOTE]
  > * One list item represents one room.
  > * The maximum number of guests per room is `10`:
  >   * Maximum number of adults per room is `6`.
  >   * Maximum number of children per room is `4`.
  > * The maximum number of rooms per request is `9`.
  > * The multiroom search:
  >   * Each request should have from `2` to `9` rooms.
  >   * A request may contain rooms with different number of guests.
  >   * Once the request is sent, you can’t:
  >     * Change the number of guests or rooms.
  >     * Cancel one of the guests or rooms.
  > 
  >   The ETG API returns rooms suitable for the maximum number of the requested guests.
  <ul>
  <li>
  <p><strong>adults</strong> <em>(Int)</em></p>
  <p>The number of adult guests in one room.</p>
  > [!NOTE]
  > * The minimum value is `1`.
  > * The maximum value is `6`.
  </li>
  <li>
  <p><strong>children</strong> <em>([Int])</em></p>
  <p>The age list of the children who will stay in the room.</p>
  > [!NOTE]
  > * The maximum age per child is `17` years.
  > * The maximum number of children in the room is `4`.
  </li>
  </ul>
  </li>
  </ul>


[//]: # (hotels)
- **hotels** *([Object])*

  <p>The list of hotels and their rates.</p>
  <ul>
  <li>
  <p><strong>id</strong> <em>(String, deprecated)</em></p>
  <p>The unique hotel ID in the legacy string format.</p>
  > [!NOTE]
  > * Either this field or the `hid` field is required.
  </li>
  <li>
  <p><strong>hid</strong> <em>(Int)</em></p>
  <p>The unique hotel ID in the new numeric format.</p>
  > [!NOTE]
  > * Each ID is an integer no longer than 10 digits.
  > * We are gradually migrating all clients to use this format.
  </li>
  <li>
  <p><strong>rates</strong> <em>([Object])</em></p>
  <p>The list of available hotel rates.</p>
  <ul>
  <li>
  <p><strong>allotment</strong> <em>(Int)</em></p>
  <p>The number of rooms available for the rate.</p>
  </li>
  <li>
  <p><strong>amenities_data</strong> <em>([String])</em></p>
  <p>The room amenities list.</p>
  <p>To get all available room amenities and their definitions, use the <code>room_amenities</code> field from the [Retrieve hotel static data](/docs/b2b-api/static-content/retrieve-hotel-static-data/)
   call.</p>
  </li>
  <li>
  <p><strong>any_residency</strong> <em>(Boolean)</em></p>
  <p>Whether the rate is allowed to be booked by the guest with any kind of residency or not.</p>
  <p>Use it if you don’t collect the guests’ residency.</p>
  </li>
  <li>
  <p><strong>book_hash</strong> <em>(String)</em></p>
  <p>The unique rate ID used to identify the selected rate.</p>
  > [!NOTE]
  > * Use this value in the `hash` field of the [Prebook rate from hotelpage step](/docs/b2b-api/hotel-search/prebook-rate-from-hotelpage-step/) call.
  > * The value lifetime is 24 hours after you have got the available rate.
  </li>
  <li>
  <p><strong>daily_prices</strong> <em>([String])</em></p>
  <p>The list of daily rate prices breakdown in the request currency.</p>
  </li>
  <li>
  <p><strong>deposit</strong> <em>(Object)</em></p>
  <p>The deposit information of the order.</p>
  <p>Has a value if the rate <code>payment_types.type</code> field has the <code>hotel</code> value.</p>
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The deposit amount in the currency specified by the <code>currency_code</code> field.</p>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>The deposit amount currency code. Is the same as the charged (hotel) currency code.</p>
  </li>
  <li>
  <p><strong>is_refundable</strong> <em>(Boolean)</em></p>
  <p>Whether the deposit is refundable or not.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>match_hash</strong> <em>(String)</em></p>
  <p>The <code>match_hash</code> field of the rate from the call made by the SERP mechanism.</p>
  <p>Use this field if you are:</p>
  <ul>
  <li>Showing rates to the users from the call made by the [SERP mechanism](/docs/glossary/#search-engine-results-page)
  .</li>
  <li>Making a booking from these rates.</li>
  <li>Using this call response as actual data on the rate.</li>
  <li>Using this call response to actualize the exact rate from the calls made by the SERP mechanism.</li>
  </ul>
  <p>Usage of this field can help the ETG collect analytics for SERP-HP matching.</p>
  </li>
  <li>
  <p><strong>meal</strong> <em>(String, deprecated)</em></p>
  <blockquote>
  <p>[!WARNING]
  Use the <code>meal_data</code> field instead.</p></blockquote>
  <p>The meal type.</p>
  <p>If there is no meal type provided by the rate source, the <code>nomeal</code> value is returned.</p>
  <p>To get all available meals and their definitions, use the <code>meals</code> field from the [Retrieve hotel static data](/docs/b2b-api/static-content/retrieve-hotel-static-data/)
   call.</p>
  </li>
  <li>
  <p><strong>meal_data</strong> <em>(Object)</em></p>
  <p>The rate meals information.</p>
  <ul>
  <li>
  <p><strong>value</strong> <em>(String)</em></p>
  <p>The meal type in the rate.</p>
  <p>To get all available meal types and their definitions, use the <code>meals</code> field from the [Retrieve hotel static data](/docs/b2b-api/static-content/retrieve-hotel-static-data/)
   call.</p>
  <p>Has the <code>nomeal</code> value if no meal type is provided.</p>
  </li>
  <li>
  <p><strong>has_breakfast</strong> <em>(Boolean)</em></p>
  <p>Whether breakfast is included to the rate or not.</p>
  </li>
  <li>
  <p><strong>no_child_meal</strong> <em>(Boolean)</em></p>
  <p>Whether the children meal is absent in the rate or not.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>no_show</strong> <em>(Object)</em></p>
  <p>The no-show penalty information.</p>
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The no-show penalty amount in the currency specified by the <code>currency_code</code> field.</p>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>The no-show penalty amount currency code. Is the same as the charged (hotel) currency code.</p>
  </li>
  <li>
  <p><strong>from_time</strong> <em>(String)</em></p>
  <p>The time in the hotel timezone from which the no-show penalty is charged, in <code>HH:MM:SS</code> format (24-hour).</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>payment_options</strong> <em>(Object)</em></p>
  <p>The accepted payment options with the specified amount to be charged.</p>
  <p>For a booking, this amount in the requested currency should be paid.</p>
  <ul>
  <li>
  <p><strong>payment_types</strong> <em>(String)</em></p>
  <p>The list with accepted payment options.</p>
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The amount to be charged for the booking in the contract currency code.</p>
  </li>
  <li>
  <p><strong>by</strong> <em>(String)</em></p>
  <p>Whether the booking can be paid by a card or not.</p>
  > [!NOTE]
  > * The possible values:
  >   * `credit_card`
  >   * `null`
  </li>
  <li>
  <p><strong>cancellation_penalties</strong> <em>(String)</em></p>
  <p>The cancellation rules and commission information.</p>
  <ul>
  <li>
  <p><strong>free_cancellation_before</strong> <em>(String)</em></p>
  <p>The date and time when the free cancellation policy expires.</p>
  <p>Has the <code>null</code> value, if there is no free cancellation.</p>
  <p>The timezone is in UTC±0.</p>
  </li>
  <li>
  <p><strong>policies</strong> <em>(String)</em></p>
  <p>The cancellation policies breakdown by periods.</p>
  <ul>
  <li>
  <p><strong>amount_charge</strong> <em>(String)</em></p>
  <p>The cancellation penalty amount in the contract currency.</p>
  </li>
  <li>
  <p><strong>amount_show</strong> <em>(String)</em></p>
  <p>The cancellation penalty amount in the request currency.</p>
  </li>
  <li>
  <p><strong>commission_info</strong> <em>([Object])</em></p>
  <p>The commission information.</p>
  <ul>
  <li>
  <p><strong>charge</strong> <em>([Object])</em></p>
  <p>The commission information in the charge (contract) currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>show</strong> <em>([Object])</em></p>
  <p>The commission information in the requested currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>end_at</strong> <em>(String)</em></p>
  <p>The date and time when this cancellation policy expires.</p>
  <p>Has the <code>null</code> value, if it is in the time from the <code>start_at</code> field value till check-in.</p>
  <p>If the <code>start_at</code> and <code>end_at</code> fields have the <code>null</code> value, this particular cancellation policy:</p>
  <ul>
  <li>Has no time restrictions.</li>
  <li>Is in effect all the time.</li>
  </ul>
  <p>The timezone is in UTC±0.</p>
  </li>
  <li>
  <p><strong>start_at</strong> <em>(String)</em></p>
  <p>The date and time when this cancellation policy takes effect.</p>
  <p>Has the <code>null</code> value, if it is in effect till the <code>end_at</code> field value.</p>
  <p>The timezone is in UTC±0.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>commission_info</strong> <em>([Object])</em></p>
  <p>The commission information.</p>
  <ul>
  <li>
  <p><strong>charge</strong> <em>([Object])</em></p>
  <p>The commission information in the charge (contract) currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>show</strong> <em>([Object])</em></p>
  <p>The commission information in the requested currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>The amount currency code. Is the same as the charged (contract) currency code.</p>
  > [!NOTE]
  > If the `payment_types` is `hotel`, the hotel `currency_code` will be used here.
  </li>
  <li>
  <p><strong>is_need_credit_card_data</strong> <em>(Boolean)</em></p>
  <p>Whether the credit card information is needed or not.</p>
  </li>
  <li>
  <p><strong>is_need_cvc</strong> <em>(Boolean)</em></p>
  <p>Whether the CVC is needed or not.</p>
  </li>
  <li>
  <p><strong>perks</strong> <em>(String)</em></p>
  <p>The additional services’ information.</p>
  <ul>
  <li>
  <p><strong>early_checkin</strong> <em>([Object])</em></p>
  <p>The early check-in information.</p>
  <ul>
  <li>
  <p><strong>charge_price</strong> <em>(String)</em></p>
  <p>The early check-in amount in the charge (contract) currency.</p>
  </li>
  <li>
  <p><strong>commission_info</strong> <em>([Object])</em></p>
  <p>The commission information.</p>
  <ul>
  <li>
  <p><strong>charge</strong> <em>([Object])</em></p>
  <p>The commission information in the charge (contract) currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>show</strong> <em>([Object])</em></p>
  <p>The commission information in the requested currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>is_requested</strong> <em>(Boolean)</em></p>
  <p>Whether the early check-in is requested or not.</p>
  </li>
  <li>
  <p><strong>show_price</strong> <em>(String)</em></p>
  <p>The early check-in amount in the search currency.</p>
  </li>
  <li>
  <p><strong>time</strong> <em>(String)</em></p>
  <p>The early check-in time.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>late_checkout</strong> <em>([Object])</em></p>
  <p>The late check-out information.</p>
  <ul>
  <li>
  <p><strong>charge_price</strong> <em>(String)</em></p>
  <p>The late check-out amount in the charge (contract) currency.</p>
  </li>
  <li>
  <p><strong>commission_info</strong> <em>([Object])</em></p>
  <p>The commission information.</p>
  <ul>
  <li>
  <p><strong>charge</strong> <em>([Object])</em></p>
  <p>The commission information in the charge (contract) currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>show</strong> <em>([Object])</em></p>
  <p>The commission information in the requested currency.</p>
  <ul>
  <li>
  <p><strong>amount_commission</strong> <em>(String)</em></p>
  <p>The commission amount.</p>
  </li>
  <li>
  <p><strong>amount_gross</strong> <em>(String)</em></p>
  <p>The gross price.</p>
  </li>
  <li>
  <p><strong>amount_net</strong> <em>(String)</em></p>
  <p>The net price.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>is_requested</strong> <em>(Boolean)</em></p>
  <p>Whether the late check-out is requested or not.</p>
  </li>
  <li>
  <p><strong>show_price</strong> <em>(String)</em></p>
  <p>The late check-out amount in the search currency.</p>
  </li>
  <li>
  <p><strong>time</strong> <em>(String)</em></p>
  <p>The late check-out time.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>recommended_price</strong> <em>(String)</em></p>
  <blockquote>
  <p>[!WARNING]
  This parameter is currently under development and will be available later. It can be ignored at the moment.</p></blockquote>
  <p>The price below which the rate can’t be sold on B2C website.</p>
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The deposit amount in the currency specified by the <code>currency_code</code> field.</p>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>The deposit amount currency code. Is the same as the charged (hotel) currency code.</p>
  </li>
  <li>
  <p><strong>show_amount</strong> <em>(String)</em></p>
  <p>The rate price in the request currency code of this object <code>show_currency_code</code> field value.</p>
  <p>Isn’t necessarily the sum in the charged or payment currency code.</p>
  </li>
  <li>
  <p><strong>show_currency_code</strong> <em>(String)</em></p>
  <p>The request currency code.</p>
  <p>Isn’t necessarily in the charged or payment currency code.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>show_amount</strong> <em>(String)</em></p>
  <p>The rate price in the request currency code of this object <code>show_currency_code</code> field value.</p>
  <p>Isn’t necessarily the sum in the charged or payment currency code.</p>
  </li>
  <li>
  <p><strong>show_currency_code</strong> <em>(String)</em></p>
  <p>The request currency code.</p>
  <p>Isn’t necessarily in the charged or payment currency code.</p>
  </li>
  <li>
  <p><strong>tax_data</strong> <em>(Object)</em></p>
  <p>The tax information.</p>
  <ul>
  <li>
  <p><strong>taxes</strong> <em>(Object)</em></p>
  <p>The taxes list.</p>
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The tax amount in the currency specified by the <code>currency_code</code> field.</p>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>The tax amount currency code in the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
   format.</p>
  <blockquote>
  <p>[!NOTE]</p>
  <ul>
  <li>The length is <code>3</code> characters.</li>
  <li>The possible values:
  <ul>
  <li><code>AED</code>.</li>
  <li><code>AFN</code>.</li>
  <li><code>ALL</code>.</li>
  <li><code>AMD</code>.</li>
  <li><code>ANG</code>.</li>
  <li><code>AOA</code>.</li>
  <li><code>ARS</code>.</li>
  <li><code>AUD</code>.</li>
  <li><code>AWG</code>.</li>
  <li><code>AZN</code>.</li>
  <li><code>BAM</code>.</li>
  <li><code>BBD</code>.</li>
  <li><code>BDT</code>.</li>
  <li><code>BGN</code>.</li>
  <li><code>BHD</code>.</li>
  <li><code>BIF</code>.</li>
  <li><code>BMD</code>.</li>
  <li><code>BND</code>.</li>
  <li><code>BOB</code>.</li>
  <li><code>BOV</code>.</li>
  <li><code>BRL</code>.</li>
  <li><code>BSD</code>.</li>
  <li><code>BTN</code>.</li>
  <li><code>BWP</code>.</li>
  <li><code>BYR</code>.</li>
  <li><code>BYN</code>.</li>
  <li><code>BZD</code>.</li>
  <li><code>CAD</code>.</li>
  <li><code>CDF</code>.</li>
  <li><code>CHE</code>.</li>
  <li><code>CHF</code>.</li>
  <li><code>CHW</code>.</li>
  <li><code>CLF</code>.</li>
  <li><code>CLP</code>.</li>
  <li><code>CNY</code>.</li>
  <li><code>COP</code>.</li>
  <li><code>COU</code>.</li>
  <li><code>CRC</code>.</li>
  <li><code>CUC</code>.</li>
  <li><code>CUP</code>.</li>
  <li><code>CVE</code>.</li>
  <li><code>CZK</code>.</li>
  <li><code>DJF</code>.</li>
  <li><code>DKK</code>.</li>
  <li><code>DOP</code>.</li>
  <li><code>DZD</code>.</li>
  <li><code>EGP</code>.</li>
  <li><code>ERN</code>.</li>
  <li><code>ETB</code>.</li>
  <li><code>EUR</code>.</li>
  <li><code>FJD</code>.</li>
  <li><code>FKP</code>.</li>
  <li><code>GBP</code>.</li>
  <li><code>GEL</code>.</li>
  <li><code>GHS</code>.</li>
  <li><code>GIP</code>.</li>
  <li><code>GMD</code>.</li>
  <li><code>GNF</code>.</li>
  <li><code>GTQ</code>.</li>
  <li><code>GYD</code>.</li>
  <li><code>HKD</code>.</li>
  <li><code>HNL</code>.</li>
  <li><code>HRK</code>.</li>
  <li><code>HTG</code>.</li>
  <li><code>HUF</code>.</li>
  <li><code>IDR</code>.</li>
  <li><code>ILS</code>.</li>
  <li><code>INR</code>.</li>
  <li><code>IQD</code>.</li>
  <li><code>IRR</code>.</li>
  <li><code>ISK</code>.</li>
  <li><code>JMD</code>.</li>
  <li><code>JOD</code>.</li>
  <li><code>JPY</code>.</li>
  <li><code>KES</code>.</li>
  <li><code>KGS</code>.</li>
  <li><code>KHR</code>.</li>
  <li><code>KMF</code>.</li>
  <li><code>KPW</code>.</li>
  <li><code>KRW</code>.</li>
  <li><code>KWD</code>.</li>
  <li><code>KYD</code>.</li>
  <li><code>KZT</code>.</li>
  <li><code>LAK</code>.</li>
  <li><code>LBP</code>.</li>
  <li><code>LKR</code>.</li>
  <li><code>LRD</code>.</li>
  <li><code>LSL</code>.</li>
  <li><code>LTL</code>.</li>
  <li><code>LVL</code>.</li>
  <li><code>LYD</code>.</li>
  <li><code>MAD</code>.</li>
  <li><code>MDL</code>.</li>
  <li><code>MGA</code>.</li>
  <li><code>MKD</code>.</li>
  <li><code>MMK</code>.</li>
  <li><code>MNT</code>.</li>
  <li><code>MOP</code>.</li>
  <li><code>MRO</code>.</li>
  <li><code>MUR</code>.</li>
  <li><code>MVR</code>.</li>
  <li><code>MWK</code>.</li>
  <li><code>MXN</code>.</li>
  <li><code>MXV</code>.</li>
  <li><code>MYR</code>.</li>
  <li><code>MZN</code>.</li>
  <li><code>NAD</code>.</li>
  <li><code>NGN</code>.</li>
  <li><code>NIO</code>.</li>
  <li><code>NOK</code>.</li>
  <li><code>NPR</code>.</li>
  <li><code>NZD</code>.</li>
  <li><code>OMR</code>.</li>
  <li><code>PAB</code>.</li>
  <li><code>PEN</code>.</li>
  <li><code>PGK</code>.</li>
  <li><code>PHP</code>.</li>
  <li><code>PKR</code>.</li>
  <li><code>PLN</code>.</li>
  <li><code>PYG</code>.</li>
  <li><code>QAR</code>.</li>
  <li><code>RON</code>.</li>
  <li><code>RSD</code>.</li>
  <li><code>RUB</code>.</li>
  <li><code>RWF</code>.</li>
  <li><code>SAR</code>.</li>
  <li><code>SBD</code>.</li>
  <li><code>SCR</code>.</li>
  <li><code>SDG</code>.</li>
  <li><code>SEK</code>.</li>
  <li><code>SGD</code>.</li>
  <li><code>SHP</code>.</li>
  <li><code>SLL</code>.</li>
  <li><code>SOS</code>.</li>
  <li><code>SRD</code>.</li>
  <li><code>SSP</code>.</li>
  <li><code>STD</code>.</li>
  <li><code>SVC</code>.</li>
  <li><code>SYP</code>.</li>
  <li><code>SZL</code>.</li>
  <li><code>THB</code>.</li>
  <li><code>TJS</code>.</li>
  <li><code>TMT</code>.</li>
  <li><code>TND</code>.</li>
  <li><code>TOP</code>.</li>
  <li><code>TRY</code>.</li>
  <li><code>TTD</code>.</li>
  <li><code>TWD</code>.</li>
  <li><code>TZS</code>.</li>
  <li><code>UAH</code>.</li>
  <li><code>UGX</code>.</li>
  <li><code>USD</code>.</li>
  <li><code>USN</code>.</li>
  <li><code>USS</code>.</li>
  <li><code>UYI</code>.</li>
  <li><code>UYU</code>.</li>
  <li><code>UZS</code>.</li>
  <li><code>VEF</code>.</li>
  <li><code>VND</code>.</li>
  <li><code>VUV</code>.</li>
  <li><code>WST</code>.</li>
  <li><code>XAF</code>.</li>
  <li><code>XAG</code>.</li>
  <li><code>XAU</code>.</li>
  <li><code>XBA</code>.</li>
  <li><code>XBB</code>.</li>
  <li><code>XBC</code>.</li>
  <li><code>XBD</code>.</li>
  <li><code>XCD</code>.</li>
  <li><code>XDR</code>.</li>
  <li><code>XFU</code>.</li>
  <li><code>XOF</code>.</li>
  <li><code>XPD</code>.</li>
  <li><code>XPF</code>.</li>
  <li><code>XPT</code>.</li>
  <li><code>XSU</code>.</li>
  <li><code>XTS</code>.</li>
  <li><code>XUA</code>.</li>
  <li><code>YER</code>.</li>
  <li><code>ZAR</code>.</li>
  <li><code>ZMW</code>.</li>
  <li><code>ZWL</code>.</li>
  </ul>
  </li>
  </ul></blockquote>
  </li>
  <li>
  <p><strong>included_by_supplier</strong> <em>(Boolean)</em></p>
  <p>Whether the tax is included by the supplier or not.</p>
  <p>When it has:</p>
  <ul>
  <li>The <code>false</code> value, the tax is supposed to be paid at the hotel in this object currency.</li>
  <li>The <code>true</code> value, the tax is included in the price.</li>
  </ul>
  </li>
  <li>
  <p><strong>name</strong> <em>(String)</em></p>
  <p>The ETG tax ID.</p>
  <p>To get all available tax IDs and their definitions, use the <code>taxes</code> field from the [Retrieve hotel static data](/docs/b2b-api/static-content/retrieve-hotel-static-data/)
   call.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>type</strong> <em>(String)</em></p>
  <p>The payment type.</p>
  > [!NOTE]
  > * The possible values:
  >   * `now`. Use it to allow the user to pay for the booking via the ETG payment system:
  >     1. Request the [Create booking process](/docs/b2b-api/booking/create-booking-process/) call and get the card details.
  >     1. Request the [Create credit card token](/docs/b2b-api/booking/create-credit-card-token/) call with the card details.
  >   * `hotel`. Use it to allow the user to pay for the booking upon check-in at the hotel. The user won’t be charged now.
  >   * `deposit`. Use it to allow you to charge the user bank card for the booking by yourself:
  >     1. You need to keep your ETG deposit sufficient. To increase funds, contact your account manager.
  >     1. The user makes a booking.
  >     1. You charge the user bank card.
  >     1. The ETG writes funds from your deposit by themselves during the reporting period.
  > 
  >     Every payment goes under a credit limit for the deposit.
  </li>
  <li>
  <p><strong>vat_data</strong> <em>(Object)</em></p>
  <p>The rate VAT information.</p>
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The VAT amount in the currency specified by the <code>currency_code</code> field.</p>
  <p>If the value is <code>0</code>, it means that the rate is without VAT. Otherwise, the rate includes VAT.</p>
  </li>
  <li>
  <p><strong>applied</strong> <em>(Boolean)</em></p>
  <p>Whether the VAT is applied or not.</p>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>The amount currency code in the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
   format.</p>
  <blockquote>
  <p>[!NOTE]</p>
  <ul>
  <li>The length is <code>3</code> characters.</li>
  <li>The possible values:
  <ul>
  <li><code>AED</code>.</li>
  <li><code>AFN</code>.</li>
  <li><code>ALL</code>.</li>
  <li><code>AMD</code>.</li>
  <li><code>ANG</code>.</li>
  <li><code>AOA</code>.</li>
  <li><code>ARS</code>.</li>
  <li><code>AUD</code>.</li>
  <li><code>AWG</code>.</li>
  <li><code>AZN</code>.</li>
  <li><code>BAM</code>.</li>
  <li><code>BBD</code>.</li>
  <li><code>BDT</code>.</li>
  <li><code>BGN</code>.</li>
  <li><code>BHD</code>.</li>
  <li><code>BIF</code>.</li>
  <li><code>BMD</code>.</li>
  <li><code>BND</code>.</li>
  <li><code>BOB</code>.</li>
  <li><code>BOV</code>.</li>
  <li><code>BRL</code>.</li>
  <li><code>BSD</code>.</li>
  <li><code>BTN</code>.</li>
  <li><code>BWP</code>.</li>
  <li><code>BYR</code>.</li>
  <li><code>BYN</code>.</li>
  <li><code>BZD</code>.</li>
  <li><code>CAD</code>.</li>
  <li><code>CDF</code>.</li>
  <li><code>CHE</code>.</li>
  <li><code>CHF</code>.</li>
  <li><code>CHW</code>.</li>
  <li><code>CLF</code>.</li>
  <li><code>CLP</code>.</li>
  <li><code>CNY</code>.</li>
  <li><code>COP</code>.</li>
  <li><code>COU</code>.</li>
  <li><code>CRC</code>.</li>
  <li><code>CUC</code>.</li>
  <li><code>CUP</code>.</li>
  <li><code>CVE</code>.</li>
  <li><code>CZK</code>.</li>
  <li><code>DJF</code>.</li>
  <li><code>DKK</code>.</li>
  <li><code>DOP</code>.</li>
  <li><code>DZD</code>.</li>
  <li><code>EGP</code>.</li>
  <li><code>ERN</code>.</li>
  <li><code>ETB</code>.</li>
  <li><code>EUR</code>.</li>
  <li><code>FJD</code>.</li>
  <li><code>FKP</code>.</li>
  <li><code>GBP</code>.</li>
  <li><code>GEL</code>.</li>
  <li><code>GHS</code>.</li>
  <li><code>GIP</code>.</li>
  <li><code>GMD</code>.</li>
  <li><code>GNF</code>.</li>
  <li><code>GTQ</code>.</li>
  <li><code>GYD</code>.</li>
  <li><code>HKD</code>.</li>
  <li><code>HNL</code>.</li>
  <li><code>HRK</code>.</li>
  <li><code>HTG</code>.</li>
  <li><code>HUF</code>.</li>
  <li><code>IDR</code>.</li>
  <li><code>ILS</code>.</li>
  <li><code>INR</code>.</li>
  <li><code>IQD</code>.</li>
  <li><code>IRR</code>.</li>
  <li><code>ISK</code>.</li>
  <li><code>JMD</code>.</li>
  <li><code>JOD</code>.</li>
  <li><code>JPY</code>.</li>
  <li><code>KES</code>.</li>
  <li><code>KGS</code>.</li>
  <li><code>KHR</code>.</li>
  <li><code>KMF</code>.</li>
  <li><code>KPW</code>.</li>
  <li><code>KRW</code>.</li>
  <li><code>KWD</code>.</li>
  <li><code>KYD</code>.</li>
  <li><code>KZT</code>.</li>
  <li><code>LAK</code>.</li>
  <li><code>LBP</code>.</li>
  <li><code>LKR</code>.</li>
  <li><code>LRD</code>.</li>
  <li><code>LSL</code>.</li>
  <li><code>LTL</code>.</li>
  <li><code>LVL</code>.</li>
  <li><code>LYD</code>.</li>
  <li><code>MAD</code>.</li>
  <li><code>MDL</code>.</li>
  <li><code>MGA</code>.</li>
  <li><code>MKD</code>.</li>
  <li><code>MMK</code>.</li>
  <li><code>MNT</code>.</li>
  <li><code>MOP</code>.</li>
  <li><code>MRO</code>.</li>
  <li><code>MUR</code>.</li>
  <li><code>MVR</code>.</li>
  <li><code>MWK</code>.</li>
  <li><code>MXN</code>.</li>
  <li><code>MXV</code>.</li>
  <li><code>MYR</code>.</li>
  <li><code>MZN</code>.</li>
  <li><code>NAD</code>.</li>
  <li><code>NGN</code>.</li>
  <li><code>NIO</code>.</li>
  <li><code>NOK</code>.</li>
  <li><code>NPR</code>.</li>
  <li><code>NZD</code>.</li>
  <li><code>OMR</code>.</li>
  <li><code>PAB</code>.</li>
  <li><code>PEN</code>.</li>
  <li><code>PGK</code>.</li>
  <li><code>PHP</code>.</li>
  <li><code>PKR</code>.</li>
  <li><code>PLN</code>.</li>
  <li><code>PYG</code>.</li>
  <li><code>QAR</code>.</li>
  <li><code>RON</code>.</li>
  <li><code>RSD</code>.</li>
  <li><code>RUB</code>.</li>
  <li><code>RWF</code>.</li>
  <li><code>SAR</code>.</li>
  <li><code>SBD</code>.</li>
  <li><code>SCR</code>.</li>
  <li><code>SDG</code>.</li>
  <li><code>SEK</code>.</li>
  <li><code>SGD</code>.</li>
  <li><code>SHP</code>.</li>
  <li><code>SLL</code>.</li>
  <li><code>SOS</code>.</li>
  <li><code>SRD</code>.</li>
  <li><code>SSP</code>.</li>
  <li><code>STD</code>.</li>
  <li><code>SVC</code>.</li>
  <li><code>SYP</code>.</li>
  <li><code>SZL</code>.</li>
  <li><code>THB</code>.</li>
  <li><code>TJS</code>.</li>
  <li><code>TMT</code>.</li>
  <li><code>TND</code>.</li>
  <li><code>TOP</code>.</li>
  <li><code>TRY</code>.</li>
  <li><code>TTD</code>.</li>
  <li><code>TWD</code>.</li>
  <li><code>TZS</code>.</li>
  <li><code>UAH</code>.</li>
  <li><code>UGX</code>.</li>
  <li><code>USD</code>.</li>
  <li><code>USN</code>.</li>
  <li><code>USS</code>.</li>
  <li><code>UYI</code>.</li>
  <li><code>UYU</code>.</li>
  <li><code>UZS</code>.</li>
  <li><code>VEF</code>.</li>
  <li><code>VND</code>.</li>
  <li><code>VUV</code>.</li>
  <li><code>WST</code>.</li>
  <li><code>XAF</code>.</li>
  <li><code>XAG</code>.</li>
  <li><code>XAU</code>.</li>
  <li><code>XBA</code>.</li>
  <li><code>XBB</code>.</li>
  <li><code>XBC</code>.</li>
  <li><code>XBD</code>.</li>
  <li><code>XCD</code>.</li>
  <li><code>XDR</code>.</li>
  <li><code>XFU</code>.</li>
  <li><code>XOF</code>.</li>
  <li><code>XPD</code>.</li>
  <li><code>XPF</code>.</li>
  <li><code>XPT</code>.</li>
  <li><code>XSU</code>.</li>
  <li><code>XTS</code>.</li>
  <li><code>XUA</code>.</li>
  <li><code>YER</code>.</li>
  <li><code>ZAR</code>.</li>
  <li><code>ZMW</code>.</li>
  <li><code>ZWL</code>.</li>
  </ul>
  </li>
  </ul></blockquote>
  </li>
  <li>
  <p><strong>included</strong> <em>(Boolean)</em></p>
  <p>Whether the VAT is included or not.</p>
  <p>If the value is <code>false</code>, it means that the rate is without VAT. Otherwise, the rate includes VAT.</p>
  </li>
  <li>
  <p><strong>value</strong> <em>(Float, deprecated)</em></p>
  <p>The VAT amount in the currency of this object <code>currency_code</code> field value.</p>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>is_package</strong> <em>(Boolean)</em></p>
  <p>Rates marked with <code>is_package = true</code> should be sold as a part of package, and the price for the hotel should not be shown separately.</p>
  </li>
  <li>
  <p><strong>bar_rate_price_data</strong> <em>(Object)</em></p>
  <p>Contains information about the BAR (Best Available Rate), which is the lowest publicly available rate for a hotel room.</p>
  > [!NOTE]
  > This field is available only upon request. Please contact  your account manager if you need access to this data.
  <ul>
  <li>
  <p><strong>amount</strong> <em>(String)</em></p>
  <p>The BAR price value in the currency specified by the <code>currency_code</code> field. It represents the lowest publicly available price for a room.</p>
  </li>
  <li>
  <p><strong>currency_code</strong> <em>(String)</em></p>
  <p>Currency of the BAR price.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>rg_ext</strong> <em>(Object)</em></p>
  <p>The hotel room type.</p>
  <p>Use this field to get extra data on the room from the hotel static data. For example, room images, descriptions.</p>
  <ul>
  <li>
  <p><strong>balcony</strong> <em>(Int)</em></p>
  <p>Whether there is a balcony or not.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — no balcony.
  > * `1` — a balcony.
  </li>
  <li>
  <p><strong>bathroom</strong> <em>(Int)</em></p>
  <p>The room bathroom information.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — a shared bathroom.
  > * `2` — a private bathroom.
  > * `3` — an external private bathroom.
  </li>
  <li>
  <p><strong>bedding</strong> <em>(Int)</em></p>
  <p>The room bedding information.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — a bunk bed.
  > * `2` — a single bed.
  > * `3` — a double bed.
  > * `4` — a twin bed.
  > * `7` — multiple beds.
  </li>
  <li>
  <p><strong>bedrooms</strong> <em>(Int)</em></p>
  <p>The bedroom number.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — 1 bedroom.
  > * `2` — 2 bedrooms.
  > * `3` — 3 bedrooms.
  > * `4` — 4 bedrooms.
  > * `5` — 5 bedrooms.
  > * `6` — 6 bedrooms.
  </li>
  <li>
  <p><strong>capacity</strong> <em>(Int)</em></p>
  <p>The maximum number of main bed places without additional charges and excluding extra beds, cots, etc.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — single.
  > * `2` — double.
  > * `3` — triple.
  > * `4` — quadruple.
  > * `5` — quintuple.
  > * `6` — sextuplet.
  </li>
  <li>
  <p><strong>class</strong> <em>(Int)</em></p>
  <p>The room class information.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — run of house.
  > * `1` — dorm.
  > * `2` — capsule.
  > * `3` — room.
  > * `4` — junior suite.
  > * `5` — suite.
  > * `6` — apartment.
  > * `7` — studio.
  > * `8` — villa.
  > * `9` — cottage.
  > * `17` — bungalow.
  > * `18` — chalet.
  > * `19` — camping.
  > * `20` — tent.
  </li>
  <li>
  <p><strong>club</strong> <em>(Int)</em></p>
  <p>Whether it is a club room or not.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — not a club room.
  > * `1` — a club room.
  </li>
  <li>
  <p><strong>family</strong> <em>(Int)</em></p>
  <p>Whether it is a family room or not.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — not a family room.
  > * `1` — a family room.
  </li>
  <li>
  <p><strong>floor</strong> <em>(Int)</em></p>
  <p>The room floor Information.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — a penthouse floor.
  > * `2` — a duplex floor.
  > * `3` — a basement floor.
  > * `4` — an attic floor.
  </li>
  <li>
  <p><strong>quality</strong> <em>(Int)</em></p>
  <p>The room quality information.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — economy.
  > * `2` — standard.
  > * `3` — comfort.
  > * `4` — business.
  > * `5` — superior.
  > * `6` — deluxe.
  > * `7` — premier.
  > * `8` — executive.
  > * `9` — presidential.
  > * `17` — premium.
  > * `18` — classic.
  > * `19` — ambassador.
  > * `20` — grand.
  > * `21` — luxury.
  > * `22` — platinum.
  > * `23` — prestige.
  > * `24` — privilege.
  > * `25` — royal.
  </li>
  <li>
  <p><strong>sex</strong> <em>(Int)</em></p>
  <p>The room gender restrictions.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — male.
  > * `2` — female.
  > * `3` — mixed.
  </li>
  <li>
  <p><strong>view</strong> <em>(Int)</em></p>
  <p>The room view information.</p>
  > [!NOTE]
  > The possible values:
  > * `0` — undefined.
  > * `1` — bay view.
  > * `2` — bosphorus view.
  > * `3` — burj-khalifa view.
  > * `4` — canal view.
  > * `5` — city view.
  > * `6` — courtyard view.
  > * `7` — dubai-marina view.
  > * `8` — garden view.
  > * `9` — golf view.
  > * `17` — harbour view.
  > * `18` — inland view.
  > * `19` — kremlin view.
  > * `20` — lake view.
  > * `21` — land view.
  > * `22` — mountain view.
  > * `23` — ocean view.
  > * `24` — panoramic view.
  > * `25` — park view.
  > * `26` — partial-ocean view.
  > * `27` — partial-sea view.
  > * `28` — partial view.
  > * `29` — pool view.
  > * `30` — river view.
  > * `31` — sea view.
  > * `32` — sheikh-zayed view.
  > * `33` — street view.
  > * `34` — sunrise view.
  > * `35` — sunset view.
  > * `36` — water view.
  > * `37` — with view.
  > * `38` — beachfront.
  > * `39` — ocean front.
  > * `40` — sea front.
  </li>
  </ul>
  </li>
  <li>
  <p><strong>room_data_trans</strong> <em>(Object)</em></p>
  <p>The room information in the request language.</p>
  <ul>
  <li>
  <p><strong>bathroom</strong> <em>(String)</em></p>
  <p>The room bathroom information.</p>
  <p>Has the <code>null</code> value, if it is a private bathroom.</p>
  </li>
  <li>
  <p><strong>bedding_type</strong> <em>(String)</em></p>
  <p>The room bedding information.</p>
  </li>
  <li>
  <p><strong>main_name</strong> <em>(String)</em></p>
  <p>The room name.</p>
  </li>
  <li>
  <p><strong>main_room_type</strong> <em>(String)</em></p>
  <p>The room type.</p>
  </li>
  <li>
  <p><strong>misc_room_type</strong> <em>(String)</em></p>
  <p>The room additional information.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>legal_info</strong> <em>(Object)</em></p>
  <p>The hotel and service provider legal information.</p>
  > [!NOTE]
  > The information provided depends on the supplier of the specific rate.
  <p>Has the value different from <code>null</code> for only countries where it is mandatory to have this information.</p>
  <p>Has the <code>null</code> value for the calls made by the [SERP mechanism](/docs/glossary/#search-engine-results-page)
  .</p>
  <ul>
  <li>
  <p><strong>hotel</strong> <em>(Object)</em></p>
  <p>The hotel legal information.</p>
  <ul>
  <li>
  <p><strong>name</strong> <em>(String)</em></p>
  <p>The hotel legal name.</p>
  </li>
  <li>
  <p><strong>address</strong> <em>(String)</em></p>
  <p>The hotel legal address.</p>
  </li>
  <li>
  <p><strong>taxpayer_number</strong> <em>(String)</em></p>
  <p>The Taxpayer Personal Identification Number (INN) of the hotel.</p>
  > [!NOTE]
  > * The length is `10` characters.
  </li>
  <li>
  <p><strong>state_registration_number</strong> <em>(String)</em></p>
  <p>The State Registration Number for Companies (OGRN) of the hotel.</p>
  > [!NOTE]
  > * The length is `13` characters.
  </li>
  <li>
  <p><strong>work_time</strong> <em>(String)</em></p>
  <p>The hotel legal address working hours.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>provider</strong> <em>(Object)</em></p>
  <p>The service provider legal information.</p>
  <ul>
  <li>
  <p><strong>name</strong> <em>(String)</em></p>
  <p>The service provider legal name.</p>
  </li>
  <li>
  <p><strong>address</strong> <em>(String)</em></p>
  <p>The service provider legal address.</p>
  </li>
  <li>
  <p><strong>taxpayer_number</strong> <em>(String)</em></p>
  <p>The Taxpayer Personal Identification Number (INN) of the service provider.</p>
  > [!NOTE]
  > * The length is `10` characters.
  </li>
  <li>
  <p><strong>state_registration_number</strong> <em>(String)</em></p>
  <p>The State Registration Number for Companies (OGRN) of the service provider.</p>
  > [!NOTE]
  > * The length is `13` characters.
  </li>
  </ul>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>room_name</strong> <em>(String)</em></p>
  <p>The room name in the request language.</p>
  </li>
  <li>
  <p><strong>room_name_info</strong> <em>(Object)</em></p>
  <p>The optional object that may help to resolve certain matching problems. To get access to the object, contact your account manager.</p>
  </li>
  <li>
  <p><strong>sell_price_limits</strong> <em>(Object)</em></p>
  <p>Information on the restrictions on the final selling price for the client.</p>
  > [!NOTE]
  > This field is available only upon request. Please contact  your account manager if you need access to this data.
  <p>If not <code>null</code>, the final selling price should be:</p>
  <ul>
  <li>Within the <code>min_price</code> and <code>max_price</code> field values.</li>
  <li>In the search currency.</li>
  </ul>
  <ul>
  <li>
  <p><strong>min_price</strong> <em>(String)</em></p>
  <p>The minimum final selling price for the client in the search currency.</p>
  </li>
  <li>
  <p><strong>max_price</strong> <em>(String)</em></p>
  <p>The maximum final selling price for the client in the search currency.</p>
  </li>
  </ul>
  </li>
  <li>
  <p><strong>serp_filters</strong> <em>([String], deprecated)</em></p>
  <p>The list of hotel amenities. Accepts a list of limited hotel amenities of amenity values. This limit is not stable and may vary between different rates within the same hotel — some values may be applicable for one rate but not considered for another.</p>
  <blockquote>
  <p>[!NOTE]
  Supported values:</p>
  <ul>
  <li>has_airport_transfer.</li>
  <li>has_parking.</li>
  <li>air-conditioning.</li>
  <li>has_internet.</li>
  <li>has_breakfast.</li>
  </ul></blockquote>
  </li>
  </ul>
  </li>
  </ul>





## Response example

```json
{
  "data": {
    "hotels": [
      {
        "id": "conrad_los_angeles",
        "hid": 10004834,
        "rates": [
          {
            "book_hash": "h-7e16d7a9-fe3c-5ba0-8aa1-0ea5b851afe7",
            "match_hash": "m-850df586-6e03-5044-ba4f-4f5d0d7e8651",
            "daily_prices": [
              "299.00"
            ],
            "meal": "nomeal",
            "meal_data": {
              "value": "nomeal",
              "has_breakfast": false,
              "no_child_meal": true
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "27062.00",
                  "show_amount": "299.00",
                  "currency_code": "EUR",
                  "show_currency_code": "EUR",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": true,
                        "amount": "41.24",
                        "currency_code": "EUR"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": false,
                        "amount": "45.00",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "299.00",
                      "amount_net": "299.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "27062.00",
                      "amount_net": "27062.00",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": "2026-05-18T07:00:00",
                        "amount_charge": "0.00",
                        "amount_show": "0.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          },
                          "charge": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          }
                        }
                      },
                      {
                        "start_at": "2026-05-18T07:00:00",
                        "end_at": null,
                        "amount_charge": "27062.00",
                        "amount_show": "299.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "299.00",
                            "amount_net": "299.00",
                            "amount_commission": "0.00"
                          },
                          "charge": {
                            "amount_gross": "27062.00",
                            "amount_net": "27062.00",
                            "amount_commission": "0.00"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": "2026-05-18T07:00:00"
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": {
              "amount": "390.00",
              "currency_code": "EUR"
            },
            "rg_ext": {
              "class": 3,
              "quality": 17,
              "sex": 0,
              "bathroom": 2,
              "bedding": 3,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Premium Double room (full double bed) (king size bed)",
            "room_name_info": {
              "original_rate_name": "Premium One King Bed"
            },
            "serp_filters": [
              "has_bathroom",
              "has_internet"
            ],
            "sell_price_limits": null,
            "allotment": 1,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": false,
            "deposit": null,
            "no_show": null,
            "room_data_trans": {
              "main_room_type": "Premium Double room",
              "main_name": "Premium Double room",
              "bathroom": null,
              "bedding_type": "full double bed",
              "misc_room_type": "king size bed"
            },
            "legal_info": {
              "provider": {
                "name": "",
                "address": "",
                "taxpayer_number": "0000000000",
                "state_registration_number": "0000000000000"
              },
              "hotel": {
                "name": "Conrad Los Angeles",
                "address": "100 South Grand Avenue, Los Angeles",
                "taxpayer_number": "0000000000",
                "state_registration_number": "0000000000000",
                "work_time": "from 9-18 local time"
              }
            },
            "is_package": false
          }
        ],
        "bar_price_data": null
      }
    ],
    "original_request_params": {
      "checkin": "2026-05-25",
      "checkout": "2026-05-26",
      "guests": [
        {
          "adults": 2,
          "children": []
        }
      ],
      "residency": "us"
    }
  },
  "debug": {
    "api_endpoint": {
      "endpoint": "api/b2b/v3/search/lookuprate",
      "is_active": true,
      "is_limited": true,
      "remaining": 29,
      "requests_number": 30,
      "reset": "2026-01-16T12:51:00",
      "seconds_number": 60
    },
    "request": {
      "book_hash": "h-7e16d7a9-fe3c-5ba0-8aa1-0ea5b851afe7",
      "language": "en"
    },
    "method": "POST",
    "real_ip": "104.30.161.77",
    "request_id": "8d5ca365f5f455d978060d43e2e293a9",
    "key_id": 1234,
    "api_key_id": 1234,
    "utcnow": "2026-01-16T12:50:21.366240"
  },
  "status": "ok",
  "error": null
}
```

## Errors

The `error` field has the value specified in the headers below.

### `invalid_params`

The `book_hash` field is required.

### `contract_mismatch`

An attempt to make the to check the rate found with the different contract.

### `rate_not_found`

* The rate with the `book_hash` field value isn’t found.
* The `book_hash` field value has expired.

Send another search request and change the `book_hash` field value.

### `core_search_error`

An internal search error. Has `500` status code.