Sign in

Batch fetch hotels by GIATA IDs

Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.

post/hotels/giata/batch

Request body

giata_idsinteger[] required

Array of GIATA IDs to look up (max 1000). Integer-valued strings are also accepted.

Example request

{
  "giata_ids": [
    99999999,
    99999998
  ]
}

Response

List of matching hotels

idstring required

Unique hotel identifier

namestring required

Hotel name

descriptionstring nullable required

Marketing description of the hotel (null if not available)

addressstring nullable

Street address of the hotel

postal_codestring nullable required

Postal code (null if not available)

citystring nullable required

City name (null if not available)

country_codestring nullable required

Country code (ISO 3166-1 alpha-2, null if not available)

latitudenumber nullable

Geographic latitude in decimal degrees

longitudenumber nullable

Geographic longitude in decimal degrees

languagestring nullable required

Primary language at the hotel (ISO 639-1 code)

star_ratingnumber nullable required

Official hotel star rating, e.g. 4 or 4.5 (null if not available)

room_countinteger nullable

Total number of rooms (null if not configured)

website_urlstring uri nullable required

Hotel website URL (null if not available)

emailstring email nullable required

Hotel reception email address (null if not available)

certifiedboolean required

Whether the hotel holds a current Valpas certification

certified_fromstring date nullable required

Date when the hotel's Valpas certification becomes valid (YYYY-MM-DD)

certified_untilstring date nullable required

Date when the hotel's Valpas certification expires (YYYY-MM-DD)

certification_urlstring uri nullable required

Link target for the Valpas certification badge (null when the hotel is not certified)

netstorming_idstring nullable required

Netstorming integration identifier

giata_idinteger nullable required

GIATA MultiCodes property identifier (null if the hotel is not mapped to a GIATA code, or if your API key lacks the giata scope)

Example response

[
  {
    "id": "00391351-e308-4aae-8b66-d868ebb37ff3",
    "name": "Grand Helsinki Hotel",
    "description": "A refined stay in the heart of Helsinki, steps from the central railway station.",
    "address": "Mannerheimintie 1, 00100 Helsinki",
    "postal_code": "00100",
    "city": "Helsinki",
    "country_code": "FI",
    "latitude": 60.1699,
    "longitude": 24.9384,
    "language": "fi",
    "star_rating": 4.5,
    "room_count": 85,
    "website_url": "https://www.grandhelsinkihotel.com",
    "email": "reception@grandhelsinkihotel.com",
    "images": [
      {
        "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg",
        "caption": "Great Room Lobby"
      }
    ],
    "certified": true,
    "certified_from": "2026-01-15",
    "certified_until": "2026-03-30",
    "certification_url": "https://valpashotels.com",
    "netstorming_id": "45373",
    "giata_id": 99999999
  }
]

Changes

Changed in 2 of the 4 revisions of this API.2