GET hotels/{hotelId}/guests?key={key}&fromDate={fromDate}&toDate={toDate}

Gets all Guests for the hotel specified that have been created on a specific date range (max. 60 days).

Request Information

URI Parameters

NameDescriptionTypeAdditional information
hotelId

Hotel-Id => checked against the calling applications permissions

string

Required

key

API - Key identifying the caller

string

Required

fromDate

Start of the date range the guest was created in, Format: YYYY-MM-DD

date

Required

toDate

End of the date range the guest was created in, Format: YYYY-MM-DD

date

Required

Body Parameters

None.

Response Information

Resource Description

List of Guest

Collection of Guest
NameDescriptionTypeAdditional information
Address1

Guests main address

string

None.

Address2

Guests secondary Address

string

None.

Cell1

Guests main Cell phone

string

None.

Cell2

Guests secondary Cell-Phone (e.g. work)

string

None.

City1

Guests main city

string

None.

City2

Guests secondary City

string

None.

Country1

Guests main country ISO-Country-Code e.g. CA for Canada

string

None.

Country2

ISO-Country-Code e.g. CA for Canada

string

None.

CreatedDate

Date the Guest was created in the system

date

None.

Email1

Guests main email

string

None.

Email2

Guests secondary email (e.g. work)

string

None.

EmailPromotion

Defines whether the Guests wants to receive promotional emails

boolean

None.

FirstName

Guests first name

string

None.

GuestId

Unique Roomkey - Guest Id

integer

None.

GuestType

Type of guest like wholeseler, travel agent etc.

string

None.

HotelId

Id of the hotel the guest "belongs" to

string

None.

IsGuestTaxExtempt

Flag shows if guest is tax extempt

boolean

None.

LastName

Guests last name

string

None.

LoyaltyNumber

Guests loyalty number

string

None.

Phone1

Guests main Phone

string

None.

Phone2

Guests secondary phone (e.g. work)

string

None.

State1

ISO-State-Code e.g BC for British Columbia

string

None.

State2

ISO-State-Code e.g BC for British Columbia

string

None.

Title

Guests title

string

None.

VIP

VIP indicator

boolean

None.

VIPCode

Guests VIP codes

string

None.

Zip1

Guests main Zip-Code

string

None.

Zip2

Guests secondary Zip-Code

string

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "Cell1": "sample string 3",
    "Cell2": "sample string 4",
    "City1": "sample string 5",
    "City2": "sample string 6",
    "Country1": "sample string 7",
    "Country2": "sample string 8",
    "CreatedDate": "2024-03-28T07:29:26.8427924-07:00",
    "Email1": "sample string 10",
    "Email2": "sample string 11",
    "EmailPromotion": true,
    "FirstName": "sample string 13",
    "GuestId": 14,
    "GuestType": "sample string 15",
    "HotelId": "sample string 16",
    "IsGuestTaxExtempt": true,
    "LastName": "sample string 18",
    "LoyaltyNumber": "sample string 19",
    "Phone1": "sample string 20",
    "Phone2": "sample string 21",
    "State1": "sample string 22",
    "State2": "sample string 23",
    "Title": "sample string 24",
    "VIP": true,
    "VIPCode": "sample string 26",
    "Zip1": "sample string 27",
    "Zip2": "sample string 28"
  },
  {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "Cell1": "sample string 3",
    "Cell2": "sample string 4",
    "City1": "sample string 5",
    "City2": "sample string 6",
    "Country1": "sample string 7",
    "Country2": "sample string 8",
    "CreatedDate": "2024-03-28T07:29:26.8427924-07:00",
    "Email1": "sample string 10",
    "Email2": "sample string 11",
    "EmailPromotion": true,
    "FirstName": "sample string 13",
    "GuestId": 14,
    "GuestType": "sample string 15",
    "HotelId": "sample string 16",
    "IsGuestTaxExtempt": true,
    "LastName": "sample string 18",
    "LoyaltyNumber": "sample string 19",
    "Phone1": "sample string 20",
    "Phone2": "sample string 21",
    "State1": "sample string 22",
    "State2": "sample string 23",
    "Title": "sample string 24",
    "VIP": true,
    "VIPCode": "sample string 26",
    "Zip1": "sample string 27",
    "Zip2": "sample string 28"
  }
]

application/xml, text/xml

Sample:
<ArrayOfGuest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RoomKeyAPI.Models">
  <Guest>
    <Address1>sample string 1</Address1>
    <Address2>sample string 2</Address2>
    <Cell1>sample string 3</Cell1>
    <Cell2>sample string 4</Cell2>
    <City1>sample string 5</City1>
    <City2>sample string 6</City2>
    <Country1>sample string 7</Country1>
    <Country2>sample string 8</Country2>
    <CreatedDate>2024-03-28T07:29:26.8427924-07:00</CreatedDate>
    <Email1>sample string 10</Email1>
    <Email2>sample string 11</Email2>
    <EmailPromotion>true</EmailPromotion>
    <FirstName>sample string 13</FirstName>
    <GuestId>14</GuestId>
    <GuestType>sample string 15</GuestType>
    <HotelId>sample string 16</HotelId>
    <IsGuestTaxExtempt>true</IsGuestTaxExtempt>
    <LastName>sample string 18</LastName>
    <LoyaltyNumber>sample string 19</LoyaltyNumber>
    <Phone1>sample string 20</Phone1>
    <Phone2>sample string 21</Phone2>
    <State1>sample string 22</State1>
    <State2>sample string 23</State2>
    <Title>sample string 24</Title>
    <VIP>true</VIP>
    <VIPCode>sample string 26</VIPCode>
    <Zip1>sample string 27</Zip1>
    <Zip2>sample string 28</Zip2>
  </Guest>
  <Guest>
    <Address1>sample string 1</Address1>
    <Address2>sample string 2</Address2>
    <Cell1>sample string 3</Cell1>
    <Cell2>sample string 4</Cell2>
    <City1>sample string 5</City1>
    <City2>sample string 6</City2>
    <Country1>sample string 7</Country1>
    <Country2>sample string 8</Country2>
    <CreatedDate>2024-03-28T07:29:26.8427924-07:00</CreatedDate>
    <Email1>sample string 10</Email1>
    <Email2>sample string 11</Email2>
    <EmailPromotion>true</EmailPromotion>
    <FirstName>sample string 13</FirstName>
    <GuestId>14</GuestId>
    <GuestType>sample string 15</GuestType>
    <HotelId>sample string 16</HotelId>
    <IsGuestTaxExtempt>true</IsGuestTaxExtempt>
    <LastName>sample string 18</LastName>
    <LoyaltyNumber>sample string 19</LoyaltyNumber>
    <Phone1>sample string 20</Phone1>
    <Phone2>sample string 21</Phone2>
    <State1>sample string 22</State1>
    <State2>sample string 23</State2>
    <Title>sample string 24</Title>
    <VIP>true</VIP>
    <VIPCode>sample string 26</VIPCode>
    <Zip1>sample string 27</Zip1>
    <Zip2>sample string 28</Zip2>
  </Guest>
</ArrayOfGuest>