> For the complete documentation index, see [llms.txt](https://docs.globalalerting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globalalerting.com/web-api/itineraries-hotels.md).

# Itineraries Hotels

## GET /V2/{tenantVarCode}/itineraries/{itineraryId}/hotels

> Returns a list of hotes for the itinerary

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Hotels"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/hotels":{"get":{"tags":["Itineraries - Hotels"],"summary":"Returns a list of hotes for the itinerary","operationId":"GetHotels","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"application/json;IEEE754Compatible=false":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"application/json;IEEE754Compatible=true":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"application/xml":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"text/plain":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"application/octet-stream":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"text/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"text/xml":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}},"text/csv":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Hotel"}}}}}}}}},"components":{"schemas":{"Hotel":{"required":["Address","Latitude","Longitude"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"Name":{"type":"string","description":"Hotel name","nullable":true},"Address":{"minLength":1,"type":"string","description":"Hotel address"},"Latitude":{"type":"number","description":"Latitude","format":"double"},"Longitude":{"type":"number","description":"Longitude","format":"double"},"CountryName":{"type":"string","description":"Country name","nullable":true},"CountryCode":{"type":"string","description":"Two letter country code","nullable":true},"TimeZoneId":{"type":"string","description":"Time zone id","nullable":true},"CheckInTimeLocal":{"type":"string","description":"Check-in local time (required if check-in time UTC not specified)","format":"date-time","nullable":true},"CheckInTime":{"type":"string","description":"Check-in time UTC (required if check-in local time not specified)","format":"date-time","nullable":true},"CheckOutTimeLocal":{"type":"string","description":"Check-out local time (required if check-out time UTC not specified)","format":"date-time","nullable":true},"CheckOutTime":{"type":"string","description":"Check-out time UTC (required if check-out local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## POST /V2/{tenantVarCode}/itineraries/{itineraryId}/hotels

> Creates a new hotel

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Hotels"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/hotels":{"post":{"tags":["Itineraries - Hotels"],"summary":"Creates a new hotel","operationId":"PostHotel","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"description":"Hotel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/*+xml":{"schema":{"$ref":"#/components/schemas/Hotel"}}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Hotel":{"required":["Address","Latitude","Longitude"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"Name":{"type":"string","description":"Hotel name","nullable":true},"Address":{"minLength":1,"type":"string","description":"Hotel address"},"Latitude":{"type":"number","description":"Latitude","format":"double"},"Longitude":{"type":"number","description":"Longitude","format":"double"},"CountryName":{"type":"string","description":"Country name","nullable":true},"CountryCode":{"type":"string","description":"Two letter country code","nullable":true},"TimeZoneId":{"type":"string","description":"Time zone id","nullable":true},"CheckInTimeLocal":{"type":"string","description":"Check-in local time (required if check-in time UTC not specified)","format":"date-time","nullable":true},"CheckInTime":{"type":"string","description":"Check-in time UTC (required if check-in local time not specified)","format":"date-time","nullable":true},"CheckOutTimeLocal":{"type":"string","description":"Check-out local time (required if check-out time UTC not specified)","format":"date-time","nullable":true},"CheckOutTime":{"type":"string","description":"Check-out time UTC (required if check-out local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## GET /V2/{tenantVarCode}/itineraries/{itineraryId}/hotels/{hotelId}

> Returns a specific hotel

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Hotels"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/hotels/{hotelId}":{"get":{"tags":["Itineraries - Hotels"],"summary":"Returns a specific hotel","operationId":"GetHotel","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"hotelId","in":"path","description":"Hotel Id","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/octet-stream":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Hotel"}}}}}}}},"components":{"schemas":{"Hotel":{"required":["Address","Latitude","Longitude"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"Name":{"type":"string","description":"Hotel name","nullable":true},"Address":{"minLength":1,"type":"string","description":"Hotel address"},"Latitude":{"type":"number","description":"Latitude","format":"double"},"Longitude":{"type":"number","description":"Longitude","format":"double"},"CountryName":{"type":"string","description":"Country name","nullable":true},"CountryCode":{"type":"string","description":"Two letter country code","nullable":true},"TimeZoneId":{"type":"string","description":"Time zone id","nullable":true},"CheckInTimeLocal":{"type":"string","description":"Check-in local time (required if check-in time UTC not specified)","format":"date-time","nullable":true},"CheckInTime":{"type":"string","description":"Check-in time UTC (required if check-in local time not specified)","format":"date-time","nullable":true},"CheckOutTimeLocal":{"type":"string","description":"Check-out local time (required if check-out time UTC not specified)","format":"date-time","nullable":true},"CheckOutTime":{"type":"string","description":"Check-out time UTC (required if check-out local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## PUT /V2/{tenantVarCode}/itineraries/{itineraryId}/hotels/{hotelId}

> Updates an existing hotel

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Hotels"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/hotels/{hotelId}":{"put":{"tags":["Itineraries - Hotels"],"summary":"Updates an existing hotel","operationId":"PutHotel","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"hotelId","in":"path","description":"Hotel Id","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"description":"Hotel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/Hotel"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Hotel"}},"application/*+xml":{"schema":{"$ref":"#/components/schemas/Hotel"}}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Hotel":{"required":["Address","Latitude","Longitude"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"Name":{"type":"string","description":"Hotel name","nullable":true},"Address":{"minLength":1,"type":"string","description":"Hotel address"},"Latitude":{"type":"number","description":"Latitude","format":"double"},"Longitude":{"type":"number","description":"Longitude","format":"double"},"CountryName":{"type":"string","description":"Country name","nullable":true},"CountryCode":{"type":"string","description":"Two letter country code","nullable":true},"TimeZoneId":{"type":"string","description":"Time zone id","nullable":true},"CheckInTimeLocal":{"type":"string","description":"Check-in local time (required if check-in time UTC not specified)","format":"date-time","nullable":true},"CheckInTime":{"type":"string","description":"Check-in time UTC (required if check-in local time not specified)","format":"date-time","nullable":true},"CheckOutTimeLocal":{"type":"string","description":"Check-out local time (required if check-out time UTC not specified)","format":"date-time","nullable":true},"CheckOutTime":{"type":"string","description":"Check-out time UTC (required if check-out local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## DELETE /V2/{tenantVarCode}/itineraries/{itineraryId}/hotels/{hotelId}

> Deletes a specific hotel

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Hotels"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/hotels/{hotelId}":{"delete":{"tags":["Itineraries - Hotels"],"summary":"Deletes a specific hotel","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"hotelId","in":"path","description":"Hotel Id","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK"}}}}}}
```