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 VisitorViewModel| Name | 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": "5b02bbd7-a0ba-4aed-af4b-e08920c5a9db",
"GuestPersonId": "cffaf021-b220-4734-b8f6-b6577e2ef45c",
"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": "fe642210-fbd2-4392-b14d-5bd84c7d73e5",
"HostPersonId": "1268922e-793a-45c4-b579-d57e5f6554ef",
"HostFirstName": "sample string 13",
"HostLastName": "sample string 14",
"HostEmail": "sample string 15",
"HostPhone": "sample string 16",
"HostCompanyName": "sample string 17",
"FacilityId": "34ce4067-7f79-42d0-a22d-77533eeb0c6b",
"FacilityName": "sample string 18",
"ACSystemId": "5002976b-c1d7-4021-9d54-431be41bca8a",
"ACSystemName": "sample string 19",
"RequestedAccessLevel": {
"AccessLevelId": 1,
"Name": "sample string 2",
"AccessLevelStartDate": "2025-10-13T04:37:59.6581103+00:00",
"AccessLevelEndDate": "2025-10-13T04:37:59.6581103+00:00",
"Deleted": true,
"ACSystemId": "1442f8a7-0366-41db-9ebf-352dfb46c791",
"CompanyId": "11dd6623-10b6-4555-be3c-8bdb14f44627",
"ApplyByDefault": true,
"AccessLevelTypeId": "95bc2cd6-d1b3-4316-9ef7-2e656c6e8569",
"FacilityId": "0919c0a5-d099-4db3-9897-894ea8c30c9b"
},
"Deleted": true
},
{
"VisitorRequestId": "5b02bbd7-a0ba-4aed-af4b-e08920c5a9db",
"GuestPersonId": "cffaf021-b220-4734-b8f6-b6577e2ef45c",
"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": "fe642210-fbd2-4392-b14d-5bd84c7d73e5",
"HostPersonId": "1268922e-793a-45c4-b579-d57e5f6554ef",
"HostFirstName": "sample string 13",
"HostLastName": "sample string 14",
"HostEmail": "sample string 15",
"HostPhone": "sample string 16",
"HostCompanyName": "sample string 17",
"FacilityId": "34ce4067-7f79-42d0-a22d-77533eeb0c6b",
"FacilityName": "sample string 18",
"ACSystemId": "5002976b-c1d7-4021-9d54-431be41bca8a",
"ACSystemName": "sample string 19",
"RequestedAccessLevel": {
"AccessLevelId": 1,
"Name": "sample string 2",
"AccessLevelStartDate": "2025-10-13T04:37:59.6581103+00:00",
"AccessLevelEndDate": "2025-10-13T04:37:59.6581103+00:00",
"Deleted": true,
"ACSystemId": "1442f8a7-0366-41db-9ebf-352dfb46c791",
"CompanyId": "11dd6623-10b6-4555-be3c-8bdb14f44627",
"ApplyByDefault": true,
"AccessLevelTypeId": "95bc2cd6-d1b3-4316-9ef7-2e656c6e8569",
"FacilityId": "0919c0a5-d099-4db3-9897-894ea8c30c9b"
},
"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>5002976b-c1d7-4021-9d54-431be41bca8a</ACSystemId>
<ACSystemName>sample string 19</ACSystemName>
<Deleted>true</Deleted>
<FacilityId>34ce4067-7f79-42d0-a22d-77533eeb0c6b</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>cffaf021-b220-4734-b8f6-b6577e2ef45c</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>1268922e-793a-45c4-b579-d57e5f6554ef</HostPersonId>
<HostPhone>sample string 16</HostPhone>
<Message>sample string 10</Message>
<RequestedAccessLevel>
<ACSystemId>1442f8a7-0366-41db-9ebf-352dfb46c791</ACSystemId>
<AccessLevelEndDate>2025-10-13T04:37:59.6581103+00:00</AccessLevelEndDate>
<AccessLevelId>1</AccessLevelId>
<AccessLevelStartDate>2025-10-13T04:37:59.6581103+00:00</AccessLevelStartDate>
<ApplyByDefault>true</ApplyByDefault>
<CompanyId>11dd6623-10b6-4555-be3c-8bdb14f44627</CompanyId>
<Deleted>true</Deleted>
<Name>sample string 2</Name>
</RequestedAccessLevel>
<VisitationPattern>sample string 9</VisitationPattern>
<VisitorRequestId>5b02bbd7-a0ba-4aed-af4b-e08920c5a9db</VisitorRequestId>
<VisitorTypeId>fe642210-fbd2-4392-b14d-5bd84c7d73e5</VisitorTypeId>
</VisitorViewModel>
<VisitorViewModel>
<ACSystemId>5002976b-c1d7-4021-9d54-431be41bca8a</ACSystemId>
<ACSystemName>sample string 19</ACSystemName>
<Deleted>true</Deleted>
<FacilityId>34ce4067-7f79-42d0-a22d-77533eeb0c6b</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>cffaf021-b220-4734-b8f6-b6577e2ef45c</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>1268922e-793a-45c4-b579-d57e5f6554ef</HostPersonId>
<HostPhone>sample string 16</HostPhone>
<Message>sample string 10</Message>
<RequestedAccessLevel>
<ACSystemId>1442f8a7-0366-41db-9ebf-352dfb46c791</ACSystemId>
<AccessLevelEndDate>2025-10-13T04:37:59.6581103+00:00</AccessLevelEndDate>
<AccessLevelId>1</AccessLevelId>
<AccessLevelStartDate>2025-10-13T04:37:59.6581103+00:00</AccessLevelStartDate>
<ApplyByDefault>true</ApplyByDefault>
<CompanyId>11dd6623-10b6-4555-be3c-8bdb14f44627</CompanyId>
<Deleted>true</Deleted>
<Name>sample string 2</Name>
</RequestedAccessLevel>
<VisitationPattern>sample string 9</VisitationPattern>
<VisitorRequestId>5b02bbd7-a0ba-4aed-af4b-e08920c5a9db</VisitorRequestId>
<VisitorTypeId>fe642210-fbd2-4392-b14d-5bd84c7d73e5</VisitorTypeId>
</VisitorViewModel>
</ArrayOfVisitorViewModel>