---
title: 'Hotels search'
url: 'https://documentation.netstorming.net/api-reference/hotels/hotels-search-static-data'
markdown: 'https://documentation.netstorming.net/api-reference/hotels/hotels-search-static-data.md'
date: '2026-11-10'
description: 'Request The request needs to contain only the identifier of the city (tag city, attribute code) You can also set a timestamp as for the country search and the city search The (type) attribute has to be set to hotels. If you prefer to obtain all the hotels regardless of their city, you should take a…'
taxonomy:
  category:
    - docs
---

# Hotels search

[](#)  [ API reference ](https://documentation.netstorming.net/api-reference)     [ Hotels ](https://documentation.netstorming.net/api-reference/hotels)      Hotels search    

##### Request

The request needs to contain only the identifier of the city (tag **city**, attribute *code*)
You can also set a timestamp as for the country search and the city search
The (**type**) attribute has to be set to *hotels*.

If you prefer to obtain all the hotels regardless of their city, you should take a look at our new [hotels inventory API](https://documentation.netstorming.net/api-reference/hotels/hotels-inventory)

```xml
<?xml version="1.0" encoding="UTF-8"?>  
<envelope>  
    <header>  
        <actor>test</actor>     
        <user>test</user>  
        <password>test</password>  
        <version>1.6.1</version>  
        <timestamp>20030423170100</timestamp>  
    </header>  
    <query type="hotels" product="hotel">  
        <city code="VCEI"/>  
    <timestamp>20030423170100</timestamp>  
    </query>  
</envelope>
```

##### Response

The response message contains in its **response**, tag the list of all the details of the hotel in the form  as described in the following list:

- **id**: hotel'identifier
- **name**: full hotel'sname
- **stars**: number of stars
- **location**: hotel position

 [ ](https://documentation.netstorming.net/api-reference/hotels) [](https://documentation.netstorming.net/api-reference/hotels/hotels-inventory)

---

## Navigation

- Parent: [Hotels](https://documentation.netstorming.net/api-reference/hotels.md)
- Next: [Hotels inventory](https://documentation.netstorming.net/api-reference/hotels/hotels-inventory.md)