# The Hotel mini object

> The compact card of a hotel, made for a list of search results: its identity, place, stars, photos and amenities in 13 snake_case fields, about 5 KB.

Source: https://fx-port.com/docs/api/objects/hotel-mini

`search_advanced` returns one per hotel in `hotels_details[]`; `POST /hotels/search?detail_level=minimal` and `get_hotel_info` with `detail_level=minimal` return the same card. It has no price and no room: prices come from `hotels_pricing` and `get_rates`. Use it for lists and call the full document for the one hotel the user opens. See Mini and full hotel data.

## Attributes

- `id` (string): The FX-Port id of the hotel, a lower-case slug. Send it as `hotel_id` to `get_rates` and `get_hotel_info`.
- `hid` (integer): The supplier's numeric hotel id. `get_hotel_info` also accepts it as a lookup key.
- `name` (string): Name of the hotel.
- `kind` (string): Type of property as the supplier names it: `Hotel`, `Apartment`, `Resort`, `Hostel`, `Guesthouse`, `Boutique and Design` ...
- `address` (string): Street address, in English.
- `latitude` (number): Latitude of the hotel.
- `longitude` (number): Longitude of the hotel.
- `postal_code` (string, nullable): Postal code. `null` for a minority of hotels.
- `region` (object): The city or area a hotel is in.
  - `id` (integer): Supplier id of the region.
  - `country_code` (string): ISO 3166-1 alpha-2 country code, upper case.
  - `iata` (string): IATA code of the main airport or city of the region.
  - `name` (string): Name of the region, usually the city.
  - `type` (string): Kind of region as the supplier names it: `City`, `Region`, `Airport` ...
  - `type_v2` (string): The same kind in lower case (`city`). Missing for a few hotels.
- `star_rating` (integer): Number of stars, 0 to 5. `0` means the property is not rated. Between 0 and 5.
- `images` (array of string, nullable): URL templates of the hotel photos, best photo first. Replace `{size}` to get a picture: `120x120`, `240x240`, `640x400` and `1024x768` work, and so does `x500` (500 px high); `orig` does not. See "Images" in Mini and full hotel data.
- `serp_filters` (array of string): Tags to build result filters with: `has_internet`, `has_parking`, `has_pool`, `has_spa`, `has_fitness`, `has_pets`, `has_kids`, `has_meal`, `has_jacuzzi`, `has_business`, `has_smoking`, `has_disabled_support`, `has_airport_transfer`, `air_conditioning`, `kitchen`.
- `amenity_groups` (array of object): The amenities of the hotel by group. With the images it makes up about 90% of the bytes of a mini card.
  - `group_name` (string): Name of the group: `General`, `Rooms`, `Services and amenities`, `Meals`, `Sports and Recreation` ...
  - `amenities` (array of string): Every amenity of the group, free or paid.
  - `non_free_amenities` (array of string, nullable): The amenities of `amenities` that are paid at the property. `null` or empty when all are free.

## Example

```json
{
  "id": "test_hotel_do_not_book",
  "hid": 8473727,
  "name": "Test Hotel (Do Not Book) test",
  "kind": "Apartment",
  "address": "Avenida Roble, Frente al Mall Multiplaza, Tegucigalpa",
  "latitude": 14.079872,
  "longitude": -87.21677,
  "postal_code": null,
  "region": {
    "id": 3421,
    "country_code": "HN",
    "iata": "TGU",
    "name": "Tegucigalpa",
    "type": "City",
    "type_v2": "city"
  },
  "star_rating": 0,
  "images": [
    "https://cdn.worldota.net/t/{size}/extranet/b5/d3/b5d3d33394494c68321246882c1bd93a6832dcd5.jpeg",
    "https://cdn.worldota.net/t/{size}/extranet/15/44/15440558c952ec4c3488730d1563dc9e8d25832c.JPEG"
  ],
  "serp_filters": [
    "has_internet",
    "has_parking",
    "has_spa",
    "has_pets",
    "has_jacuzzi",
    "kitchen"
  ],
  "amenity_groups": [
    {
      "amenities": [
        "24-hour reception",
        "Early check-in",
        "Late check-out"
      ],
      "non_free_amenities": [],
      "group_name": "General"
    },
    {
      "amenities": [
        "Concierge services",
        "Dry-cleaning",
        "Shoe shine"
      ],
      "non_free_amenities": [
        "Dry-cleaning",
        "Shoe shine"
      ],
      "group_name": "Services and amenities"
    }
  ]
}
```