GET api/v1/VisitorRequests?HostId={HostId}
Returns a list of VisitorViewModels going to see a particular Host that the API token has rights to view
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
HostId | globally unique identifier |
Required |
Body Parameters
None.
Response Information
Resource Description
Collection of VisitorViewModelName | Description | Type | Additional information |
---|---|---|---|
VisitorRequestId |
Represents the PK of an existing Visitor Request in BluSKY |
globally unique identifier |
None. |
GuestPersonId |
Represents the PK of an existing Visitor Request Guest in BluSKY |
globally unique identifier |
None. |
GuestFirstName |
Represents the Guest's first/given name. |
string |
None. |
GuestLastName |
Represents the Guest's last name / surname. |
string |
None. |
GuestEmail |
Represents the email address of the Guest |
string |
None. |
GuestPhone |
Represents the phone number of the Guest |
string |
None. |
GuestCompanyName |
Represents the name of the occupancy or vendor instance that the Guest belongs to |
string |
None. |
GroupHashTag |
Represents the group name that the Guest may belong to (if provided) |
string |
None. |
VisitationPattern |
Represents the visitation pattern that has been requested for the Guest |
string |
None. |
Message |
Represents a supplemental message that will be viewable by Security/Reception when the Guest arrives |
string |
None. |
VisitorTypeId |
Represents a supplemental message that will be viewable by Security/Reception when the Guest arrives |
globally unique identifier |
None. |
HostPersonId |
Represents the PK of an existing Visitor Request Host in BluSKY |
globally unique identifier |
None. |
HostFirstName |
Represents the Host's first/given name. |
string |
None. |
HostLastName |
Represents the Host's last name / surname. |
string |
None. |
HostEmail |
Represents the email address of the Host |
string |
None. |
HostPhone |
Represents the phone number of the Host |
string |
None. |
HostCompanyName |
Represents the name of the occupancy or vendor instance that the Host belongs to |
string |
None. |
FacilityId |
Represents the PK of the facility that the Guest is expected at |
globally unique identifier |
None. |
FacilityName |
Represents the name of the facility that the Guest is expected at |
string |
None. |
ACSystemId |
Represents the PK of the Access Control System that the Host is located in |
globally unique identifier |
None. |
ACSystemName |
Represents the name of the Access Control System that the Host is located in |
string |
None. |
RequestedAccessLevel |
Represents an Access Level assignments requested by the Requestor for the Visitor |
AccessLevelViewModel |
None. |
Deleted |
Represents whether the Visitor Request is deleted or not. |
boolean |
None. |
Response Formats
application/json, text/json
[ { "VisitorRequestId": "ef58d431-e402-478d-9d7b-90c63aa3e025", "GuestPersonId": "cfb22531-f9eb-4dcd-8fe5-a31cbb9041e9", "GuestFirstName": "sample string 3", "GuestLastName": "sample string 4", "GuestEmail": "sample string 5", "GuestPhone": "sample string 6", "GuestCompanyName": "sample string 7", "GroupHashTag": "sample string 8", "VisitationPattern": "sample string 9", "Message": "sample string 10", "VisitorTypeId": "5c63065d-620a-4870-ab29-e76a45b6cf9b", "HostPersonId": "509548ce-0f5f-4b04-99e1-8505d1ebde70", "HostFirstName": "sample string 13", "HostLastName": "sample string 14", "HostEmail": "sample string 15", "HostPhone": "sample string 16", "HostCompanyName": "sample string 17", "FacilityId": "96920f05-fdb7-43bc-a022-d934f5c1fc08", "FacilityName": "sample string 18", "ACSystemId": "6c7cd93a-735b-4e66-a54e-a9d6ffcf706e", "ACSystemName": "sample string 19", "RequestedAccessLevel": { "AccessLevelId": 1, "Name": "sample string 2", "AccessLevelStartDate": "2025-07-26T09:45:49.0877982+00:00", "AccessLevelEndDate": "2025-07-26T09:45:49.0877982+00:00", "Deleted": true, "ACSystemId": "58f75534-11e8-456b-9270-114ffcf60f67", "CompanyId": "f52d18b3-b883-4da9-beb9-1da88266f1e7", "ApplyByDefault": true, "AccessLevelTypeId": "9202bebc-1f45-4c7f-b07a-dabd675f9e23", "FacilityId": "121d185b-0741-41fe-9dc2-26dfd38e8238" }, "Deleted": true }, { "VisitorRequestId": "ef58d431-e402-478d-9d7b-90c63aa3e025", "GuestPersonId": "cfb22531-f9eb-4dcd-8fe5-a31cbb9041e9", "GuestFirstName": "sample string 3", "GuestLastName": "sample string 4", "GuestEmail": "sample string 5", "GuestPhone": "sample string 6", "GuestCompanyName": "sample string 7", "GroupHashTag": "sample string 8", "VisitationPattern": "sample string 9", "Message": "sample string 10", "VisitorTypeId": "5c63065d-620a-4870-ab29-e76a45b6cf9b", "HostPersonId": "509548ce-0f5f-4b04-99e1-8505d1ebde70", "HostFirstName": "sample string 13", "HostLastName": "sample string 14", "HostEmail": "sample string 15", "HostPhone": "sample string 16", "HostCompanyName": "sample string 17", "FacilityId": "96920f05-fdb7-43bc-a022-d934f5c1fc08", "FacilityName": "sample string 18", "ACSystemId": "6c7cd93a-735b-4e66-a54e-a9d6ffcf706e", "ACSystemName": "sample string 19", "RequestedAccessLevel": { "AccessLevelId": 1, "Name": "sample string 2", "AccessLevelStartDate": "2025-07-26T09:45:49.0877982+00:00", "AccessLevelEndDate": "2025-07-26T09:45:49.0877982+00:00", "Deleted": true, "ACSystemId": "58f75534-11e8-456b-9270-114ffcf60f67", "CompanyId": "f52d18b3-b883-4da9-beb9-1da88266f1e7", "ApplyByDefault": true, "AccessLevelTypeId": "9202bebc-1f45-4c7f-b07a-dabd675f9e23", "FacilityId": "121d185b-0741-41fe-9dc2-26dfd38e8238" }, "Deleted": true } ]
application/xml, text/xml
<ArrayOfVisitorViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers"> <VisitorViewModel> <ACSystemId>6c7cd93a-735b-4e66-a54e-a9d6ffcf706e</ACSystemId> <ACSystemName>sample string 19</ACSystemName> <Deleted>true</Deleted> <FacilityId>96920f05-fdb7-43bc-a022-d934f5c1fc08</FacilityId> <FacilityName>sample string 18</FacilityName> <GroupHashTag>sample string 8</GroupHashTag> <GuestCompanyName>sample string 7</GuestCompanyName> <GuestEmail>sample string 5</GuestEmail> <GuestFirstName>sample string 3</GuestFirstName> <GuestLastName>sample string 4</GuestLastName> <GuestPersonId>cfb22531-f9eb-4dcd-8fe5-a31cbb9041e9</GuestPersonId> <GuestPhone>sample string 6</GuestPhone> <HostCompanyName>sample string 17</HostCompanyName> <HostEmail>sample string 15</HostEmail> <HostFirstName>sample string 13</HostFirstName> <HostLastName>sample string 14</HostLastName> <HostPersonId>509548ce-0f5f-4b04-99e1-8505d1ebde70</HostPersonId> <HostPhone>sample string 16</HostPhone> <Message>sample string 10</Message> <RequestedAccessLevel> <ACSystemId>58f75534-11e8-456b-9270-114ffcf60f67</ACSystemId> <AccessLevelEndDate>2025-07-26T09:45:49.0877982+00:00</AccessLevelEndDate> <AccessLevelId>1</AccessLevelId> <AccessLevelStartDate>2025-07-26T09:45:49.0877982+00:00</AccessLevelStartDate> <ApplyByDefault>true</ApplyByDefault> <CompanyId>f52d18b3-b883-4da9-beb9-1da88266f1e7</CompanyId> <Deleted>true</Deleted> <Name>sample string 2</Name> </RequestedAccessLevel> <VisitationPattern>sample string 9</VisitationPattern> <VisitorRequestId>ef58d431-e402-478d-9d7b-90c63aa3e025</VisitorRequestId> <VisitorTypeId>5c63065d-620a-4870-ab29-e76a45b6cf9b</VisitorTypeId> </VisitorViewModel> <VisitorViewModel> <ACSystemId>6c7cd93a-735b-4e66-a54e-a9d6ffcf706e</ACSystemId> <ACSystemName>sample string 19</ACSystemName> <Deleted>true</Deleted> <FacilityId>96920f05-fdb7-43bc-a022-d934f5c1fc08</FacilityId> <FacilityName>sample string 18</FacilityName> <GroupHashTag>sample string 8</GroupHashTag> <GuestCompanyName>sample string 7</GuestCompanyName> <GuestEmail>sample string 5</GuestEmail> <GuestFirstName>sample string 3</GuestFirstName> <GuestLastName>sample string 4</GuestLastName> <GuestPersonId>cfb22531-f9eb-4dcd-8fe5-a31cbb9041e9</GuestPersonId> <GuestPhone>sample string 6</GuestPhone> <HostCompanyName>sample string 17</HostCompanyName> <HostEmail>sample string 15</HostEmail> <HostFirstName>sample string 13</HostFirstName> <HostLastName>sample string 14</HostLastName> <HostPersonId>509548ce-0f5f-4b04-99e1-8505d1ebde70</HostPersonId> <HostPhone>sample string 16</HostPhone> <Message>sample string 10</Message> <RequestedAccessLevel> <ACSystemId>58f75534-11e8-456b-9270-114ffcf60f67</ACSystemId> <AccessLevelEndDate>2025-07-26T09:45:49.0877982+00:00</AccessLevelEndDate> <AccessLevelId>1</AccessLevelId> <AccessLevelStartDate>2025-07-26T09:45:49.0877982+00:00</AccessLevelStartDate> <ApplyByDefault>true</ApplyByDefault> <CompanyId>f52d18b3-b883-4da9-beb9-1da88266f1e7</CompanyId> <Deleted>true</Deleted> <Name>sample string 2</Name> </RequestedAccessLevel> <VisitationPattern>sample string 9</VisitationPattern> <VisitorRequestId>ef58d431-e402-478d-9d7b-90c63aa3e025</VisitorRequestId> <VisitorTypeId>5c63065d-620a-4870-ab29-e76a45b6cf9b</VisitorTypeId> </VisitorViewModel> </ArrayOfVisitorViewModel>