Hotels

This method is used to obtain a HOTELS portfolio.

Hotels Request

GET https://api.hotelbeds.com/transfer-cache-api/1.0/hotels?fields= {{FIELDS}} &language= {{LANG}} &countryCodes= {{COUNTRIES}} &destinationCodes= {{DESTINATIONS}} &codes= {{CODES}} &giataCodes= {{GIATAS}} &OFFSET= {{OFFSET}} &limit= {{LIMIT}}

Request parameters

Name Type Description
fields String Comma separated list of response fields to return (mandatory)
language String ISO 639-1 (2 digit) Language code (mandatory)
countryCodes String Comma separated ISO 3166 (2 digit) country codes (optional)
destinationCodes String Comma separated list of ATLAS destination codes (optional)
codes String Comma separated list of ATLAS hotel codes (optional)
giataCodes String Comma-separated list of GIATA hotel codes (optional)
offset int it's the position in the dataset of a particular record. By specifying offset, you retrieve a subset of records starting with the offset value (optional)
limit int allows you to set the number of objects returned in one page (optional)

Request Example:

https://api.hotelbeds.com/transfer-cache-api/1.0/hotels?fields=ALL&language=en&destinationCodes=MAO

Hotels Response

The response of Hotels provides information of the hotels

Response Parameters

Name Type Description
code String Hotel code (Atlas code)
name String Hotel Name
category String Hotel Category name
description String Hotel description
countryCode String ISO 3166 (2 digit) country code
destinationCode String Atlas destination code
city String City name
coordinates Element latitude & longitude coordinates for the hotel
coordinates/latitude Float Latitude data for geolocation
coordinates/longitude Float Longitude data for geolocation
address String Hotel address
postalCode String Hotel postal code

Response Example

[
    {
        "code": "47819",
        "name": "Jatiuca Resort",
        "category": "5EST",
        "description": "Boasting an idyllic location right on the Jatiúca Beach and surrounded by palm trees, this fantastic holiday resort offers a luxurious accommodation in a beautiful setting away from the hustle and bustle of the city. The property is situated close to many local attractions and the international airport is a 30-minute drive away. The establishment features bright rooms with a charming decoration and excellent facilities to make guests' stay as enjoyable as possible. All the rooms have a private balcony and most of them offer a stunning sea view. Visitors may choose between different dining options and the pool bar serves light snacks and refreshing drinks. During the day, guests may spend their time lying on the sun loungers by the large outdoor pool or enjoy some relaxing massages in a beautiful and calm environment. Other facilities include tennis courts, a games room and a varied entertainment programme.",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.642728368,
            "longitude": -35.6993392
        },
        "chainCode": null,
        "address": "Av. Álvaro Otacílio, 5500,5500  ",
        "postalCode": "57036-850"
    },
    {
        "code": "47821",
        "name": "Ritz Lagoa da Anta Hotel & Spa",
        "category": "5EST",
        "description": "The Ritz Lagoa da Anta is a beautiful Beach hotel and one of the most recognized hotels in Maceió, the capital of the coastal state of Alagoas, Brazil. The resort has a privileged beach front location right across from Lagoa da Anta beach, and the nearby Jatiúca and Ponta Verde beaches. The Ritz features a complete array of facilities and activities for leisure and entertainment for the whole family.\nDesigned for comfort, the Modern architecture of Hotel Ritz Lagoa da Anta Hotel offers options for leisure and business travelers. Relax by one of the three swimming pools, play tennis visit the fitness centre, have a hydro massage or pamper yourself at the Spa. Have lunch or dinner at Cana-Cafe Restaurant, featuring International cuisine and the Ritz Bistrot featuring French gastronomy. Ideal for business and events, Ritz Lagoa da Anta Hotel also has a business centre with different event rooms and the Convention Centre a modular auditorium that holds up to 1800 guests. Hotel Ritz Lagoa da Anta Hotel has been awarded for achieving the highest levels of quality in all its services. It also a member of the SAP (Safe Food Program), and was the first hotel in Brazil to win the Tropen Preiss ITB Berlin prize as \"Hotel Arts\" for his collection of works of art.\n",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.639253723,
            "longitude": -35.6990978
        },
        "chainCode": null,
        "address": "AVENIDA BRIGADEIRO NEDUARDO GOMES,546  ",
        "postalCode": "57038230"
    },
    {
        "code": "47823",
        "name": "Residenza Casa del Sole ",
        "category": "2EST",
        "description": "This hotel lies just 150 m from the wonderful local beach.\n\nThe functional complex comprises a total of 16 apartments.\n\nEach of the apartments comes fitted with a bathroom, a living room, a fully equipped kitchen, a TV and a hire safe. Air conditioning features as standard.\n\nGuests are able to make use of the swimming pool.",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": null,
            "longitude": null
        },
        "chainCode": null,
        "address": "LOT. RECIFE DO FRANCES I QD.Z PRAIA DO FRANCES,Lot. 9/8  ",
        "postalCode": null
    },
    {
        "code": "48163",
        "name": "Ponta Verde Maceio",
        "category": "4EST",
        "description": "This hotel is located in the city of Maceió, capital of the state of Alagoas. Ponta Verde beach, the most beautiful in Maceió, lies only a few paces from the hotel. The countless shops and entertainment venues of the city can also be reached in a short time.\n\nCompletely renovated and restored in 2005, this beach hotel comprises a total of 203 rooms. Guests are welcomed into the lobby with a 24-hour reception desk and lift access. Further facilities include a cosy restaurant, and it is also possible to take advantage of the room service.\n\nThe pleasant rooms all come with a tiled en suite bathroom, a direct dial telephone, a fridge, a hire safe, a hi-fi stereo system, a king-sized bed and satellite/ cable TV. The air conditioning is individually adjustable.\n\nThere is a swimming pool available for guests' use within the hotel grounds.",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.661647501,
            "longitude": -35.69692522
        },
        "chainCode": null,
        "address": "ALVARO OTACILIO, PONTA VERDE,2933  ",
        "postalCode": "57035180"
    },
    {
        "code": "48860",
        "name": "Costamar",
        "category": "3EST",
        "description": "Get ready to completely leave the routine and experience new things , walking by green areas surrounded by blue sea and spend a few days in an environment with a typical and charming decoration . Costamar , a kind hotel that welcomes you in the prime area of the city, in the most beautiful cove of the Northeast. Besides being close to the best nightclubs and restaurants and trendiest bars in Maceió , offers excellent services to its guests.\nOutdoor pool , breakfast in the panoramic restaurant , free internet Wi-Fi, 24-hour reception , free parking and other services available.\nHotel Costamar offers 66 comfortable standard rooms , all equipped with cable TV , telephone, minibar , internet and safe. Try this comfort , combined with a lot of sun , sea and tranquility.\n",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.662906517,
            "longitude": -35.7029119
        },
        "chainCode": null,
        "address": "Rua Desportista Humberto Guimaraes,420  ",
        "postalCode": "57035-030"
    },
    {
        "code": "52855",
        "name": "Ibis Maceio Pajuciara ",
        "category": "3EST",
        "description": "The ibis Maceió Pajuçara hotel stands in front of the beautiful natural pools of Pajuçara Beach, one of the most popular beaches in Maceió. The hotel is located just 0.6 mi (1 km) from the city's events center, which hosts trade fairs and shows. It combin es 2 basic requirements for a low-cost trip: good price and location, along with wonderful views of the beach. The rooms feature queen-size beds and free WIFI. As well as all the classic breakfast options, the hotel also serves delicious tapioca pancakes",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.6708365,
            "longitude": -35.7163025
        },
        "chainCode": null,
        "address": "DR. ANTONIO GOUVEIA. PAJUCARA,277  ",
        "postalCode": "57030170"
    },
    {
        "code": "61801",
        "name": "San Marino Suite",
        "category": "4EST",
        "description": "This hotel is located by Ponte Verde beach and is also near the tourist attractions, bars, and restaurants in the area.\n\nThe hotel has 126 rooms, laundry, restaurant, tv room, game room, pool for adults and children, suna steam, gym, jacuzzi, conference room for 200 people, car hire, parking and garage.\n\nAll rooms come with an en suite bathroom with warm and cold water, a king-size spring bed, air conditioning, cable TV, a direct dial telephone, a freezer, a room safe and a control panel.\n\nThere is a swimming pool available for guests' use in the hotel grounds. In addition, guests may unwind in the sauna, while sports enthusiasts can also enjoy a work-out in the gym.",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.657869,
            "longitude": -35.700138
        },
        "chainCode": null,
        "address": "Rua Doutor Noel Nutels,437  ",
        "postalCode": "57035450"
    },
    {
        "code": "73120",
        "name": "Maceio Mar",
        "category": "4EST",
        "description": "Boasting a stunning seafront setting just 5 km from Maceio, this exquisite beach hotel offers guests a peaceful location in Brazil. The hotel is situated just 30 km away from Barra de Sao Miguel and Praia Do Frances. The beautifully-decorated guest rooms feature soothing tones with subtle splashes of colour. The rooms come well equipped with modern amenities for visitors' convenience and added comfort. The hotel offers guests a host of excellent facilities, catering to the needs of every type of traveller. Guests of all ages will appreciate the swimming pool area, while the little ones will be enthralled by the excitement of the playground. Business travellers will be pleased by the business centre, allowing them to keep up with work while away.",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "MACEIO",
        "coordinates": {
            "latitude": -9.661251,
            "longitude": -35.697382
        },
        "chainCode": null,
        "address": "Avenida Alvaro Otacilio,2991  ",
        "postalCode": "57035180"
    },
    {
        "code": "728289",
        "name": "OYO Pousada Mar Verde",
        "category": "2EST",
        "description": "Pousada Mar Verde has rooms in Maceió near the Museum of Image and Sound of Alagoas and Natural Pools of Pajucara. The property is around 2.1 km from Jatiuca Beach, 3.9 km from Maceio Bus Station and 2.7 km from Port of Maceio. The property provides a 24-hour front desk and free WiFi is available throughout the property.\n\nAt the hotel, each room comes with air conditioning and a TV.\n\nA buffet breakfast is available daily at Pousada Mar Verde.\n\nPopular points of interest near the accommodation include Pajucara Beach, Ponta Verde Beach, and Cultural Center Ruth Cardoso. The nearest airport is Maceio/Zumbi dos Palmares International Airport, 30.6 km from Pousada Mar Verde.",
        "countryCode": "BR",
        "destinationCode": "MAO",
        "city": "Maceió",
        "coordinates": {
            "latitude": -9.66725726,
            "longitude": -35.71518397
        },
        "chainCode": null,
        "address": "R. Alm. Mascarenha Maceió,337  ",
        "postalCode": "57030572"
    }
]