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

Sample:

[
  {
    "VisitorRequestId": "f6fbd65d-0f49-4df0-98d7-eaf6dbe1c545",
    "GuestPersonId": "7711e3f6-af08-4b01-8ca9-31b8457a0551",
    "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": "2d741c04-f601-4704-a4aa-da429ac68109",
    "HostPersonId": "cb4a332e-4c95-4152-a74d-9c92b3e1c1da",
    "HostFirstName": "sample string 13",
    "HostLastName": "sample string 14",
    "HostEmail": "sample string 15",
    "HostPhone": "sample string 16",
    "HostCompanyName": "sample string 17",
    "FacilityId": "02cef263-3f18-4ea8-8e74-eda985ad26f2",
    "FacilityName": "sample string 18",
    "ACSystemId": "abe438ac-53d7-4929-94d5-52e46288c2ba",
    "ACSystemName": "sample string 19",
    "RequestedAccessLevel": {
      "AccessLevelId": 1,
      "Name": "sample string 2",
      "AccessLevelStartDate": "2025-03-10T22:32:53.9363362+00:00",
      "AccessLevelEndDate": "2025-03-10T22:32:53.9363362+00:00",
      "Deleted": true,
      "ACSystemId": "384fc100-2b4c-4312-b034-1426d6df641e",
      "CompanyId": "f5ad73bb-b09c-4dfa-bbdc-c27a40ba2c8b",
      "ApplyByDefault": true,
      "AccessLevelTypeId": "6ac7eb94-e110-437e-af9e-6a559b5e6f1e",
      "FacilityId": "81f67be3-33bb-4d3e-b985-26843ba9a481"
    },
    "Deleted": true
  },
  {
    "VisitorRequestId": "f6fbd65d-0f49-4df0-98d7-eaf6dbe1c545",
    "GuestPersonId": "7711e3f6-af08-4b01-8ca9-31b8457a0551",
    "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": "2d741c04-f601-4704-a4aa-da429ac68109",
    "HostPersonId": "cb4a332e-4c95-4152-a74d-9c92b3e1c1da",
    "HostFirstName": "sample string 13",
    "HostLastName": "sample string 14",
    "HostEmail": "sample string 15",
    "HostPhone": "sample string 16",
    "HostCompanyName": "sample string 17",
    "FacilityId": "02cef263-3f18-4ea8-8e74-eda985ad26f2",
    "FacilityName": "sample string 18",
    "ACSystemId": "abe438ac-53d7-4929-94d5-52e46288c2ba",
    "ACSystemName": "sample string 19",
    "RequestedAccessLevel": {
      "AccessLevelId": 1,
      "Name": "sample string 2",
      "AccessLevelStartDate": "2025-03-10T22:32:53.9363362+00:00",
      "AccessLevelEndDate": "2025-03-10T22:32:53.9363362+00:00",
      "Deleted": true,
      "ACSystemId": "384fc100-2b4c-4312-b034-1426d6df641e",
      "CompanyId": "f5ad73bb-b09c-4dfa-bbdc-c27a40ba2c8b",
      "ApplyByDefault": true,
      "AccessLevelTypeId": "6ac7eb94-e110-437e-af9e-6a559b5e6f1e",
      "FacilityId": "81f67be3-33bb-4d3e-b985-26843ba9a481"
    },
    "Deleted": true
  }
]

application/xml, text/xml

Sample:

<ArrayOfVisitorViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <VisitorViewModel>
    <ACSystemId>abe438ac-53d7-4929-94d5-52e46288c2ba</ACSystemId>
    <ACSystemName>sample string 19</ACSystemName>
    <Deleted>true</Deleted>
    <FacilityId>02cef263-3f18-4ea8-8e74-eda985ad26f2</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>7711e3f6-af08-4b01-8ca9-31b8457a0551</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>cb4a332e-4c95-4152-a74d-9c92b3e1c1da</HostPersonId>
    <HostPhone>sample string 16</HostPhone>
    <Message>sample string 10</Message>
    <RequestedAccessLevel>
      <ACSystemId>384fc100-2b4c-4312-b034-1426d6df641e</ACSystemId>
      <AccessLevelEndDate>2025-03-10T22:32:53.9363362+00:00</AccessLevelEndDate>
      <AccessLevelId>1</AccessLevelId>
      <AccessLevelStartDate>2025-03-10T22:32:53.9363362+00:00</AccessLevelStartDate>
      <ApplyByDefault>true</ApplyByDefault>
      <CompanyId>f5ad73bb-b09c-4dfa-bbdc-c27a40ba2c8b</CompanyId>
      <Deleted>true</Deleted>
      <Name>sample string 2</Name>
    </RequestedAccessLevel>
    <VisitationPattern>sample string 9</VisitationPattern>
    <VisitorRequestId>f6fbd65d-0f49-4df0-98d7-eaf6dbe1c545</VisitorRequestId>
    <VisitorTypeId>2d741c04-f601-4704-a4aa-da429ac68109</VisitorTypeId>
  </VisitorViewModel>
  <VisitorViewModel>
    <ACSystemId>abe438ac-53d7-4929-94d5-52e46288c2ba</ACSystemId>
    <ACSystemName>sample string 19</ACSystemName>
    <Deleted>true</Deleted>
    <FacilityId>02cef263-3f18-4ea8-8e74-eda985ad26f2</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>7711e3f6-af08-4b01-8ca9-31b8457a0551</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>cb4a332e-4c95-4152-a74d-9c92b3e1c1da</HostPersonId>
    <HostPhone>sample string 16</HostPhone>
    <Message>sample string 10</Message>
    <RequestedAccessLevel>
      <ACSystemId>384fc100-2b4c-4312-b034-1426d6df641e</ACSystemId>
      <AccessLevelEndDate>2025-03-10T22:32:53.9363362+00:00</AccessLevelEndDate>
      <AccessLevelId>1</AccessLevelId>
      <AccessLevelStartDate>2025-03-10T22:32:53.9363362+00:00</AccessLevelStartDate>
      <ApplyByDefault>true</ApplyByDefault>
      <CompanyId>f5ad73bb-b09c-4dfa-bbdc-c27a40ba2c8b</CompanyId>
      <Deleted>true</Deleted>
      <Name>sample string 2</Name>
    </RequestedAccessLevel>
    <VisitationPattern>sample string 9</VisitationPattern>
    <VisitorRequestId>f6fbd65d-0f49-4df0-98d7-eaf6dbe1c545</VisitorRequestId>
    <VisitorTypeId>2d741c04-f601-4704-a4aa-da429ac68109</VisitorTypeId>
  </VisitorViewModel>
</ArrayOfVisitorViewModel>