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": "adc06623-b0a4-4834-801b-192f739f14e5",
"GuestPersonId": "20131bb7-7b1d-43b6-8b67-c4e2cb8b9b05",
"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": "f715dc80-942b-4400-b405-598ef5050c0e",
"HostPersonId": "815328c1-081a-4208-b8f4-262a25d06396",
"HostFirstName": "sample string 13",
"HostLastName": "sample string 14",
"HostEmail": "sample string 15",
"HostPhone": "sample string 16",
"HostCompanyName": "sample string 17",
"FacilityId": "8a11647e-c5ff-4a12-9388-bc3fe309188f",
"FacilityName": "sample string 18",
"ACSystemId": "00559a2e-4014-470e-b78e-111c808ef8f1",
"ACSystemName": "sample string 19",
"RequestedAccessLevel": {
"AccessLevelId": 1,
"Name": "sample string 2",
"AccessLevelStartDate": "2026-05-10T05:18:00.9866276+00:00",
"AccessLevelEndDate": "2026-05-10T05:18:00.9866276+00:00",
"Deleted": true,
"ACSystemId": "576e4dae-1bce-463b-9667-35f1a88ea7e9",
"CompanyId": "065b87bb-88ff-4bb2-8d46-266294f912b9",
"ApplyByDefault": true,
"AccessLevelTypeId": "dea7773b-b1b8-49e6-9dd7-9416f51fafed",
"FacilityId": "056e524d-78ca-425c-84bd-8b9a4a2c51f5"
},
"Deleted": true
},
{
"VisitorRequestId": "adc06623-b0a4-4834-801b-192f739f14e5",
"GuestPersonId": "20131bb7-7b1d-43b6-8b67-c4e2cb8b9b05",
"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": "f715dc80-942b-4400-b405-598ef5050c0e",
"HostPersonId": "815328c1-081a-4208-b8f4-262a25d06396",
"HostFirstName": "sample string 13",
"HostLastName": "sample string 14",
"HostEmail": "sample string 15",
"HostPhone": "sample string 16",
"HostCompanyName": "sample string 17",
"FacilityId": "8a11647e-c5ff-4a12-9388-bc3fe309188f",
"FacilityName": "sample string 18",
"ACSystemId": "00559a2e-4014-470e-b78e-111c808ef8f1",
"ACSystemName": "sample string 19",
"RequestedAccessLevel": {
"AccessLevelId": 1,
"Name": "sample string 2",
"AccessLevelStartDate": "2026-05-10T05:18:00.9866276+00:00",
"AccessLevelEndDate": "2026-05-10T05:18:00.9866276+00:00",
"Deleted": true,
"ACSystemId": "576e4dae-1bce-463b-9667-35f1a88ea7e9",
"CompanyId": "065b87bb-88ff-4bb2-8d46-266294f912b9",
"ApplyByDefault": true,
"AccessLevelTypeId": "dea7773b-b1b8-49e6-9dd7-9416f51fafed",
"FacilityId": "056e524d-78ca-425c-84bd-8b9a4a2c51f5"
},
"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>00559a2e-4014-470e-b78e-111c808ef8f1</ACSystemId>
<ACSystemName>sample string 19</ACSystemName>
<Deleted>true</Deleted>
<FacilityId>8a11647e-c5ff-4a12-9388-bc3fe309188f</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>20131bb7-7b1d-43b6-8b67-c4e2cb8b9b05</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>815328c1-081a-4208-b8f4-262a25d06396</HostPersonId>
<HostPhone>sample string 16</HostPhone>
<Message>sample string 10</Message>
<RequestedAccessLevel>
<ACSystemId>576e4dae-1bce-463b-9667-35f1a88ea7e9</ACSystemId>
<AccessLevelEndDate>2026-05-10T05:18:00.9866276+00:00</AccessLevelEndDate>
<AccessLevelId>1</AccessLevelId>
<AccessLevelStartDate>2026-05-10T05:18:00.9866276+00:00</AccessLevelStartDate>
<ApplyByDefault>true</ApplyByDefault>
<CompanyId>065b87bb-88ff-4bb2-8d46-266294f912b9</CompanyId>
<Deleted>true</Deleted>
<Name>sample string 2</Name>
</RequestedAccessLevel>
<VisitationPattern>sample string 9</VisitationPattern>
<VisitorRequestId>adc06623-b0a4-4834-801b-192f739f14e5</VisitorRequestId>
<VisitorTypeId>f715dc80-942b-4400-b405-598ef5050c0e</VisitorTypeId>
</VisitorViewModel>
<VisitorViewModel>
<ACSystemId>00559a2e-4014-470e-b78e-111c808ef8f1</ACSystemId>
<ACSystemName>sample string 19</ACSystemName>
<Deleted>true</Deleted>
<FacilityId>8a11647e-c5ff-4a12-9388-bc3fe309188f</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>20131bb7-7b1d-43b6-8b67-c4e2cb8b9b05</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>815328c1-081a-4208-b8f4-262a25d06396</HostPersonId>
<HostPhone>sample string 16</HostPhone>
<Message>sample string 10</Message>
<RequestedAccessLevel>
<ACSystemId>576e4dae-1bce-463b-9667-35f1a88ea7e9</ACSystemId>
<AccessLevelEndDate>2026-05-10T05:18:00.9866276+00:00</AccessLevelEndDate>
<AccessLevelId>1</AccessLevelId>
<AccessLevelStartDate>2026-05-10T05:18:00.9866276+00:00</AccessLevelStartDate>
<ApplyByDefault>true</ApplyByDefault>
<CompanyId>065b87bb-88ff-4bb2-8d46-266294f912b9</CompanyId>
<Deleted>true</Deleted>
<Name>sample string 2</Name>
</RequestedAccessLevel>
<VisitationPattern>sample string 9</VisitationPattern>
<VisitorRequestId>adc06623-b0a4-4834-801b-192f739f14e5</VisitorRequestId>
<VisitorTypeId>f715dc80-942b-4400-b405-598ef5050c0e</VisitorTypeId>
</VisitorViewModel>
</ArrayOfVisitorViewModel>