---
title: 'Cities search'
url: 'https://documentation.netstorming.net/api-reference/static-details-search/cities-search'
markdown: 'https://documentation.netstorming.net/api-reference/static-details-search/cities-search.md'
date: '2026-11-10'
description: 'Request The request needs to contain only the identifier of the country (tag country, attribute code) You can also set a timestamp as for the country search The (type) attribute has to be set to cities. <?xml version="1.0" encoding="UTF-8"?> <envelope> <he…'
taxonomy:
  category:
    - docs
---

# Cities search

[](#)  [ API reference ](https://documentation.netstorming.net/api-reference)     [ Static details search ](https://documentation.netstorming.net/api-reference/static-details-search)      Cities search    

##### Request

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

```xml
<?xml version="1.0" encoding="UTF-8"?>  
<envelope>  
    <header>  
        <actor>test</actor>     
        <user>test</user>  
        <password>test</password>  
        <version>1.6.3</version>  
        <timestamp>20190423170100</timestamp>  
    </header>  
    <query type="cities" product="hotel">  
        <country code="I"/>  
        <timestamp>20190423170100</timestamp>  
    </query>  
</envelope>
```

##### Response

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

- **code**
    - city's ISO identifier
- **city\_tax**
    - states if a city tax is expected, it's a boolean true/false value
- **names**
    - city's names in the available languages

 [ ](https://documentation.netstorming.net/api-reference/static-details-search/countries-search) [](https://documentation.netstorming.net/api-reference/static-details-search/zones-search)

---

## Navigation

- Parent: [Static details search](https://documentation.netstorming.net/api-reference/static-details-search.md)
- Previous: [Countries search](https://documentation.netstorming.net/api-reference/static-details-search/countries-search.md)
- Next: [Zones search](https://documentation.netstorming.net/api-reference/static-details-search/zones-search.md)