GET api/v1/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 VisitorRequestInstanceViewModel| Name | 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": "56e2223b-7a3e-455c-be48-917318a8a048",
"VisitorRequestId": "d2d5d677-8f79-4c53-a548-baacc35a8318",
"DateExpected": "2026-10-16T01:50:30.8559711+00:00",
"DateTimeArrived": "2026-10-16T01:50:30.8559711+00:00",
"AssignedAccessLevelId": 1,
"FirstName": "sample string 4",
"LastName": "sample string 5",
"MiddleInitial": "sample string 6",
"GuestCompany": "sample string 7",
"HostPersonId": "b105b325-2e7f-4d00-a3ea-f75425d57a1e",
"Message": "sample string 9",
"sVisitorTypeId": "0b5a41a0-3ee6-4e79-93a2-224317dbb34f",
"GroupHashTag": "sample string 11",
"VisitorStatus": 0,
"Deleted": true,
"Card": {
"PersonCardId": "881ec10b-fa62-45f4-a298-c8b8b18fc489",
"CardName": "sample string 2",
"CardId": "23c97b78-9a1e-4ed6-b7ee-0425fbaac7a9",
"CardType": 4,
"CardACSystemId": "a19d3c0c-4a91-4d10-a231-9af83a12fc98",
"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": "2026-10-16T01:50:30.8559711+00:00",
"DateInserted": "2026-10-16T01:50:30.8559711+00:00",
"DateUpdated": "2026-10-16T01:50:30.8559711+00:00",
"CardActivationStartDateTime": "2026-10-16T01:50:30.8559711+00:00",
"CardDeactivationStartDateTime": "2026-10-16T01:50:30.8559711+00:00",
"CardUserFlags": 1,
"EncryptedMobileCredentials": [
{
"MobileKeySetId": "68632b2d-1908-4052-9e31-9e14a99726c2",
"KeyIndex": 2,
"EncryptedCredential": "sample string 3"
},
{
"MobileKeySetId": "68632b2d-1908-4052-9e31-9e14a99726c2",
"KeyIndex": 2,
"EncryptedCredential": "sample string 3"
}
],
"CredentialType": 1
}
},
{
"VisitorRequestInstanceId": "56e2223b-7a3e-455c-be48-917318a8a048",
"VisitorRequestId": "d2d5d677-8f79-4c53-a548-baacc35a8318",
"DateExpected": "2026-10-16T01:50:30.8559711+00:00",
"DateTimeArrived": "2026-10-16T01:50:30.8559711+00:00",
"AssignedAccessLevelId": 1,
"FirstName": "sample string 4",
"LastName": "sample string 5",
"MiddleInitial": "sample string 6",
"GuestCompany": "sample string 7",
"HostPersonId": "b105b325-2e7f-4d00-a3ea-f75425d57a1e",
"Message": "sample string 9",
"sVisitorTypeId": "0b5a41a0-3ee6-4e79-93a2-224317dbb34f",
"GroupHashTag": "sample string 11",
"VisitorStatus": 0,
"Deleted": true,
"Card": {
"PersonCardId": "881ec10b-fa62-45f4-a298-c8b8b18fc489",
"CardName": "sample string 2",
"CardId": "23c97b78-9a1e-4ed6-b7ee-0425fbaac7a9",
"CardType": 4,
"CardACSystemId": "a19d3c0c-4a91-4d10-a231-9af83a12fc98",
"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": "2026-10-16T01:50:30.8559711+00:00",
"DateInserted": "2026-10-16T01:50:30.8559711+00:00",
"DateUpdated": "2026-10-16T01:50:30.8559711+00:00",
"CardActivationStartDateTime": "2026-10-16T01:50:30.8559711+00:00",
"CardDeactivationStartDateTime": "2026-10-16T01:50:30.8559711+00:00",
"CardUserFlags": 1,
"EncryptedMobileCredentials": [
{
"MobileKeySetId": "68632b2d-1908-4052-9e31-9e14a99726c2",
"KeyIndex": 2,
"EncryptedCredential": "sample string 3"
},
{
"MobileKeySetId": "68632b2d-1908-4052-9e31-9e14a99726c2",
"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>a19d3c0c-4a91-4d10-a231-9af83a12fc98</CardACSystemId>
<CardACSystemName>sample string 6</CardACSystemName>
<CardActivationStartDateTime>2026-10-16T01:50:30.8559711+00:00</CardActivationStartDateTime>
<CardDeactivationStartDateTime>2026-10-16T01:50:30.8559711+00:00</CardDeactivationStartDateTime>
<CardId>23c97b78-9a1e-4ed6-b7ee-0425fbaac7a9</CardId>
<CardName>sample string 2</CardName>
<CardSerialNumber>1</CardSerialNumber>
<CardType>4</CardType>
<CardUserFlags>ActiveCardholderRecord</CardUserFlags>
<CredentialType>Proximity</CredentialType>
<DateInserted>2026-10-16T01:50:30.8559711+00:00</DateInserted>
<DateUpdated>2026-10-16T01:50:30.8559711+00:00</DateUpdated>
<EncryptedMobileCredentials>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>68632b2d-1908-4052-9e31-9e14a99726c2</MobileKeySetId>
</EncryptedCredentialData>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>68632b2d-1908-4052-9e31-9e14a99726c2</MobileKeySetId>
</EncryptedCredentialData>
</EncryptedMobileCredentials>
<ExternalCardNumber>sample string 8</ExternalCardNumber>
<FacilityCode>9</FacilityCode>
<HidInvitationCode>sample string 13</HidInvitationCode>
<InternalCardNumber>7</InternalCardNumber>
<InvitationRedeemedDateTime>2026-10-16T01:50:30.8559711+00:00</InvitationRedeemedDateTime>
<IssueCode>10</IssueCode>
<PIN>sample string 11</PIN>
<PersonCardId>881ec10b-fa62-45f4-a298-c8b8b18fc489</PersonCardId>
</Card>
<DateExpected>2026-10-16T01:50:30.8559711+00:00</DateExpected>
<DateTimeArrived>2026-10-16T01:50:30.8559711+00:00</DateTimeArrived>
<Deleted>true</Deleted>
<FirstName>sample string 4</FirstName>
<GroupHashTag>sample string 11</GroupHashTag>
<GuestCompany>sample string 7</GuestCompany>
<HostPersonId>b105b325-2e7f-4d00-a3ea-f75425d57a1e</HostPersonId>
<LastName>sample string 5</LastName>
<Message>sample string 9</Message>
<MiddleInitial>sample string 6</MiddleInitial>
<VisitorRequestId>d2d5d677-8f79-4c53-a548-baacc35a8318</VisitorRequestId>
<VisitorRequestInstanceId>56e2223b-7a3e-455c-be48-917318a8a048</VisitorRequestInstanceId>
<VisitorStatus>NotCheckedIn</VisitorStatus>
<sVisitorTypeId>0b5a41a0-3ee6-4e79-93a2-224317dbb34f</sVisitorTypeId>
</VisitorRequestInstanceViewModel>
<VisitorRequestInstanceViewModel>
<AssignedAccessLevelId>1</AssignedAccessLevelId>
<Card>
<CardACSystemId>a19d3c0c-4a91-4d10-a231-9af83a12fc98</CardACSystemId>
<CardACSystemName>sample string 6</CardACSystemName>
<CardActivationStartDateTime>2026-10-16T01:50:30.8559711+00:00</CardActivationStartDateTime>
<CardDeactivationStartDateTime>2026-10-16T01:50:30.8559711+00:00</CardDeactivationStartDateTime>
<CardId>23c97b78-9a1e-4ed6-b7ee-0425fbaac7a9</CardId>
<CardName>sample string 2</CardName>
<CardSerialNumber>1</CardSerialNumber>
<CardType>4</CardType>
<CardUserFlags>ActiveCardholderRecord</CardUserFlags>
<CredentialType>Proximity</CredentialType>
<DateInserted>2026-10-16T01:50:30.8559711+00:00</DateInserted>
<DateUpdated>2026-10-16T01:50:30.8559711+00:00</DateUpdated>
<EncryptedMobileCredentials>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>68632b2d-1908-4052-9e31-9e14a99726c2</MobileKeySetId>
</EncryptedCredentialData>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>68632b2d-1908-4052-9e31-9e14a99726c2</MobileKeySetId>
</EncryptedCredentialData>
</EncryptedMobileCredentials>
<ExternalCardNumber>sample string 8</ExternalCardNumber>
<FacilityCode>9</FacilityCode>
<HidInvitationCode>sample string 13</HidInvitationCode>
<InternalCardNumber>7</InternalCardNumber>
<InvitationRedeemedDateTime>2026-10-16T01:50:30.8559711+00:00</InvitationRedeemedDateTime>
<IssueCode>10</IssueCode>
<PIN>sample string 11</PIN>
<PersonCardId>881ec10b-fa62-45f4-a298-c8b8b18fc489</PersonCardId>
</Card>
<DateExpected>2026-10-16T01:50:30.8559711+00:00</DateExpected>
<DateTimeArrived>2026-10-16T01:50:30.8559711+00:00</DateTimeArrived>
<Deleted>true</Deleted>
<FirstName>sample string 4</FirstName>
<GroupHashTag>sample string 11</GroupHashTag>
<GuestCompany>sample string 7</GuestCompany>
<HostPersonId>b105b325-2e7f-4d00-a3ea-f75425d57a1e</HostPersonId>
<LastName>sample string 5</LastName>
<Message>sample string 9</Message>
<MiddleInitial>sample string 6</MiddleInitial>
<VisitorRequestId>d2d5d677-8f79-4c53-a548-baacc35a8318</VisitorRequestId>
<VisitorRequestInstanceId>56e2223b-7a3e-455c-be48-917318a8a048</VisitorRequestInstanceId>
<VisitorStatus>NotCheckedIn</VisitorStatus>
<sVisitorTypeId>0b5a41a0-3ee6-4e79-93a2-224317dbb34f</sVisitorTypeId>
</VisitorRequestInstanceViewModel>
</ArrayOfVisitorRequestInstanceViewModel>