GET api/v2/VisitorRequestInstances?GuestPersonId={GuestPersonId}&Start={Start}&End={End}&IncludeCardInfo={IncludeCardInfo}
Returns all instances when passed a Guest's PersonId. Start is treated as today at 00:00:01 when null, End is treated as 00:00:01 tomorrow when null
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
GuestPersonId | globally unique identifier |
Required |
|
Start | date |
None. |
|
End | date |
None. |
|
IncludeCardInfo | boolean |
Default value is False |
Body Parameters
None.
Response Information
Resource Description
Collection of VisitorRequestInstanceViewModelName | Description | Type | Additional information |
---|---|---|---|
VisitorRequestInstanceId |
Represents the PK of an existing Visitor Request Instance in BluSKY |
globally unique identifier |
None. |
VisitorRequestId |
Represents the correspondent Visitor Request |
globally unique identifier |
None. |
DateExpected | date |
None. |
|
DateTimeArrived | date |
None. |
|
AssignedAccessLevelId | integer |
None. |
|
FirstName | string |
None. |
|
LastName | string |
None. |
|
MiddleInitial | string |
None. |
|
GuestCompany | string |
None. |
|
HostPersonId | globally unique identifier |
None. |
|
Message | string |
None. |
|
sVisitorTypeId | globally unique identifier |
None. |
|
GroupHashTag | string |
None. |
|
VisitorStatus | VisitorStatuses |
None. |
|
Deleted | boolean |
None. |
|
Card | PersonCardViewModel |
None. |
Response Formats
application/json, text/json
Sample:
[ { "VisitorRequestInstanceId": "6f1e3c72-1952-4f0d-b4f9-e4e446890cad", "VisitorRequestId": "34a724b8-b415-472f-b083-3675a72f9252", "DateExpected": "2025-08-15T12:39:18.5833249+00:00", "DateTimeArrived": "2025-08-15T12:39:18.5833249+00:00", "AssignedAccessLevelId": 1, "FirstName": "sample string 4", "LastName": "sample string 5", "MiddleInitial": "sample string 6", "GuestCompany": "sample string 7", "HostPersonId": "3bd7adc9-a233-47c4-9ecc-94bb6285fc0f", "Message": "sample string 9", "sVisitorTypeId": "060e5697-caee-458a-99c6-62f77ba58d4d", "GroupHashTag": "sample string 11", "VisitorStatus": 0, "Deleted": true, "Card": { "PersonCardId": "bad2cbd7-e7b6-4175-9cb4-308626029dc8", "CardName": "sample string 2", "CardId": "e49bc692-05f6-471a-808d-20685a6cc70f", "CardType": 4, "CardACSystemId": "c741dbaf-d4d0-492e-bf21-277251604fec", "CardACSystemName": "sample string 6", "InternalCardNumber": 7, "ExternalCardNumber": "sample string 8", "CardSerialNumber": 1, "FacilityCode": 9, "IssueCode": 10, "PIN": "sample string 11", "Deleted": true, "HidInvitationCode": "sample string 13", "InvitationRedeemedDateTime": "2025-08-15T12:39:18.5833249+00:00", "DateInserted": "2025-08-15T12:39:18.5833249+00:00", "DateUpdated": "2025-08-15T12:39:18.5833249+00:00", "CardActivationStartDateTime": "2025-08-15T12:39:18.5833249+00:00", "CardDeactivationStartDateTime": "2025-08-15T12:39:18.5833249+00:00", "CardUserFlags": 1, "EncryptedMobileCredentials": [ { "MobileKeySetId": "d8a0c59a-f87f-4115-8252-36c36d649c0e", "KeyIndex": 2, "EncryptedCredential": "sample string 3" }, { "MobileKeySetId": "d8a0c59a-f87f-4115-8252-36c36d649c0e", "KeyIndex": 2, "EncryptedCredential": "sample string 3" } ], "CredentialType": 1 } }, { "VisitorRequestInstanceId": "6f1e3c72-1952-4f0d-b4f9-e4e446890cad", "VisitorRequestId": "34a724b8-b415-472f-b083-3675a72f9252", "DateExpected": "2025-08-15T12:39:18.5833249+00:00", "DateTimeArrived": "2025-08-15T12:39:18.5833249+00:00", "AssignedAccessLevelId": 1, "FirstName": "sample string 4", "LastName": "sample string 5", "MiddleInitial": "sample string 6", "GuestCompany": "sample string 7", "HostPersonId": "3bd7adc9-a233-47c4-9ecc-94bb6285fc0f", "Message": "sample string 9", "sVisitorTypeId": "060e5697-caee-458a-99c6-62f77ba58d4d", "GroupHashTag": "sample string 11", "VisitorStatus": 0, "Deleted": true, "Card": { "PersonCardId": "bad2cbd7-e7b6-4175-9cb4-308626029dc8", "CardName": "sample string 2", "CardId": "e49bc692-05f6-471a-808d-20685a6cc70f", "CardType": 4, "CardACSystemId": "c741dbaf-d4d0-492e-bf21-277251604fec", "CardACSystemName": "sample string 6", "InternalCardNumber": 7, "ExternalCardNumber": "sample string 8", "CardSerialNumber": 1, "FacilityCode": 9, "IssueCode": 10, "PIN": "sample string 11", "Deleted": true, "HidInvitationCode": "sample string 13", "InvitationRedeemedDateTime": "2025-08-15T12:39:18.5833249+00:00", "DateInserted": "2025-08-15T12:39:18.5833249+00:00", "DateUpdated": "2025-08-15T12:39:18.5833249+00:00", "CardActivationStartDateTime": "2025-08-15T12:39:18.5833249+00:00", "CardDeactivationStartDateTime": "2025-08-15T12:39:18.5833249+00:00", "CardUserFlags": 1, "EncryptedMobileCredentials": [ { "MobileKeySetId": "d8a0c59a-f87f-4115-8252-36c36d649c0e", "KeyIndex": 2, "EncryptedCredential": "sample string 3" }, { "MobileKeySetId": "d8a0c59a-f87f-4115-8252-36c36d649c0e", "KeyIndex": 2, "EncryptedCredential": "sample string 3" } ], "CredentialType": 1 } } ]
application/xml, text/xml
Sample:
<ArrayOfVisitorRequestInstanceViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers"> <VisitorRequestInstanceViewModel> <AssignedAccessLevelId>1</AssignedAccessLevelId> <Card> <CardACSystemId>c741dbaf-d4d0-492e-bf21-277251604fec</CardACSystemId> <CardACSystemName>sample string 6</CardACSystemName> <CardActivationStartDateTime>2025-08-15T12:39:18.5833249+00:00</CardActivationStartDateTime> <CardDeactivationStartDateTime>2025-08-15T12:39:18.5833249+00:00</CardDeactivationStartDateTime> <CardId>e49bc692-05f6-471a-808d-20685a6cc70f</CardId> <CardName>sample string 2</CardName> <CardSerialNumber>1</CardSerialNumber> <CardType>4</CardType> <CardUserFlags>ActiveCardholderRecord</CardUserFlags> <CredentialType>Proximity</CredentialType> <DateInserted>2025-08-15T12:39:18.5833249+00:00</DateInserted> <DateUpdated>2025-08-15T12:39:18.5833249+00:00</DateUpdated> <EncryptedMobileCredentials> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>d8a0c59a-f87f-4115-8252-36c36d649c0e</MobileKeySetId> </EncryptedCredentialData> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>d8a0c59a-f87f-4115-8252-36c36d649c0e</MobileKeySetId> </EncryptedCredentialData> </EncryptedMobileCredentials> <ExternalCardNumber>sample string 8</ExternalCardNumber> <FacilityCode>9</FacilityCode> <HidInvitationCode>sample string 13</HidInvitationCode> <InternalCardNumber>7</InternalCardNumber> <InvitationRedeemedDateTime>2025-08-15T12:39:18.5833249+00:00</InvitationRedeemedDateTime> <IssueCode>10</IssueCode> <PIN>sample string 11</PIN> <PersonCardId>bad2cbd7-e7b6-4175-9cb4-308626029dc8</PersonCardId> </Card> <DateExpected>2025-08-15T12:39:18.5833249+00:00</DateExpected> <DateTimeArrived>2025-08-15T12:39:18.5833249+00:00</DateTimeArrived> <Deleted>true</Deleted> <FirstName>sample string 4</FirstName> <GroupHashTag>sample string 11</GroupHashTag> <GuestCompany>sample string 7</GuestCompany> <HostPersonId>3bd7adc9-a233-47c4-9ecc-94bb6285fc0f</HostPersonId> <LastName>sample string 5</LastName> <Message>sample string 9</Message> <MiddleInitial>sample string 6</MiddleInitial> <VisitorRequestId>34a724b8-b415-472f-b083-3675a72f9252</VisitorRequestId> <VisitorRequestInstanceId>6f1e3c72-1952-4f0d-b4f9-e4e446890cad</VisitorRequestInstanceId> <VisitorStatus>NotCheckedIn</VisitorStatus> <sVisitorTypeId>060e5697-caee-458a-99c6-62f77ba58d4d</sVisitorTypeId> </VisitorRequestInstanceViewModel> <VisitorRequestInstanceViewModel> <AssignedAccessLevelId>1</AssignedAccessLevelId> <Card> <CardACSystemId>c741dbaf-d4d0-492e-bf21-277251604fec</CardACSystemId> <CardACSystemName>sample string 6</CardACSystemName> <CardActivationStartDateTime>2025-08-15T12:39:18.5833249+00:00</CardActivationStartDateTime> <CardDeactivationStartDateTime>2025-08-15T12:39:18.5833249+00:00</CardDeactivationStartDateTime> <CardId>e49bc692-05f6-471a-808d-20685a6cc70f</CardId> <CardName>sample string 2</CardName> <CardSerialNumber>1</CardSerialNumber> <CardType>4</CardType> <CardUserFlags>ActiveCardholderRecord</CardUserFlags> <CredentialType>Proximity</CredentialType> <DateInserted>2025-08-15T12:39:18.5833249+00:00</DateInserted> <DateUpdated>2025-08-15T12:39:18.5833249+00:00</DateUpdated> <EncryptedMobileCredentials> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>d8a0c59a-f87f-4115-8252-36c36d649c0e</MobileKeySetId> </EncryptedCredentialData> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>d8a0c59a-f87f-4115-8252-36c36d649c0e</MobileKeySetId> </EncryptedCredentialData> </EncryptedMobileCredentials> <ExternalCardNumber>sample string 8</ExternalCardNumber> <FacilityCode>9</FacilityCode> <HidInvitationCode>sample string 13</HidInvitationCode> <InternalCardNumber>7</InternalCardNumber> <InvitationRedeemedDateTime>2025-08-15T12:39:18.5833249+00:00</InvitationRedeemedDateTime> <IssueCode>10</IssueCode> <PIN>sample string 11</PIN> <PersonCardId>bad2cbd7-e7b6-4175-9cb4-308626029dc8</PersonCardId> </Card> <DateExpected>2025-08-15T12:39:18.5833249+00:00</DateExpected> <DateTimeArrived>2025-08-15T12:39:18.5833249+00:00</DateTimeArrived> <Deleted>true</Deleted> <FirstName>sample string 4</FirstName> <GroupHashTag>sample string 11</GroupHashTag> <GuestCompany>sample string 7</GuestCompany> <HostPersonId>3bd7adc9-a233-47c4-9ecc-94bb6285fc0f</HostPersonId> <LastName>sample string 5</LastName> <Message>sample string 9</Message> <MiddleInitial>sample string 6</MiddleInitial> <VisitorRequestId>34a724b8-b415-472f-b083-3675a72f9252</VisitorRequestId> <VisitorRequestInstanceId>6f1e3c72-1952-4f0d-b4f9-e4e446890cad</VisitorRequestInstanceId> <VisitorStatus>NotCheckedIn</VisitorStatus> <sVisitorTypeId>060e5697-caee-458a-99c6-62f77ba58d4d</sVisitorTypeId> </VisitorRequestInstanceViewModel> </ArrayOfVisitorRequestInstanceViewModel>