GET api/v1/VisitorRequestInstances/NextInstance?GuestPersonId={GuestPersonId}&Start={Start}&End={End}&IncludeCardInfo={IncludeCardInfo}

Returns a single record of the next instance for a given PersonId for a Guest. "Next" is defined as any instance > 00:00:01 of current day when Start is null and less than End or if End is null, then 00:00:01 of start plus one day.

Request Information

URI Parameters

Name	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

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": "98d8b7d3-ef5b-4abd-8291-fb9e5a7a14a5",
  "VisitorRequestId": "6fd1c07a-5871-48d8-8e87-2e1a173ea81d",
  "DateExpected": "2025-12-13T00:03:14.3963687+00:00",
  "DateTimeArrived": "2025-12-13T00:03:14.3963687+00:00",
  "AssignedAccessLevelId": 1,
  "FirstName": "sample string 4",
  "LastName": "sample string 5",
  "MiddleInitial": "sample string 6",
  "GuestCompany": "sample string 7",
  "HostPersonId": "83c77f17-cf76-46bb-af9d-d63e0fe26a59",
  "Message": "sample string 9",
  "sVisitorTypeId": "0d43a8f4-66e0-4285-986d-4b57732eb6b0",
  "GroupHashTag": "sample string 11",
  "VisitorStatus": 0,
  "Deleted": true,
  "Card": {
    "PersonCardId": "e9597bd7-11ed-4cc5-94c9-a84da5c0456a",
    "CardName": "sample string 2",
    "CardId": "588f7855-be5f-4e9e-ab30-7f125d64e741",
    "CardType": 4,
    "CardACSystemId": "0a8c083a-551c-4c03-b90c-a24f259aa147",
    "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-12-13T00:03:14.3963687+00:00",
    "DateInserted": "2025-12-13T00:03:14.3963687+00:00",
    "DateUpdated": "2025-12-13T00:03:14.3963687+00:00",
    "CardActivationStartDateTime": "2025-12-13T00:03:14.3963687+00:00",
    "CardDeactivationStartDateTime": "2025-12-13T00:03:14.3963687+00:00",
    "CardUserFlags": 1,
    "EncryptedMobileCredentials": [
      {
        "MobileKeySetId": "8932c74c-19b0-48b9-9974-70dd49706cbb",
        "KeyIndex": 2,
        "EncryptedCredential": "sample string 3"
      },
      {
        "MobileKeySetId": "8932c74c-19b0-48b9-9974-70dd49706cbb",
        "KeyIndex": 2,
        "EncryptedCredential": "sample string 3"
      }
    ],
    "CredentialType": 1
  }
}

application/xml, text/xml

Sample:

<VisitorRequestInstanceViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <AssignedAccessLevelId>1</AssignedAccessLevelId>
  <Card>
    <CardACSystemId>0a8c083a-551c-4c03-b90c-a24f259aa147</CardACSystemId>
    <CardACSystemName>sample string 6</CardACSystemName>
    <CardActivationStartDateTime>2025-12-13T00:03:14.3963687+00:00</CardActivationStartDateTime>
    <CardDeactivationStartDateTime>2025-12-13T00:03:14.3963687+00:00</CardDeactivationStartDateTime>
    <CardId>588f7855-be5f-4e9e-ab30-7f125d64e741</CardId>
    <CardName>sample string 2</CardName>
    <CardSerialNumber>1</CardSerialNumber>
    <CardType>4</CardType>
    <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
    <CredentialType>Proximity</CredentialType>
    <DateInserted>2025-12-13T00:03:14.3963687+00:00</DateInserted>
    <DateUpdated>2025-12-13T00:03:14.3963687+00:00</DateUpdated>
    <EncryptedMobileCredentials>
      <EncryptedCredentialData>
        <EncryptedCredential>sample string 3</EncryptedCredential>
        <KeyIndex>2</KeyIndex>
        <MobileKeySetId>8932c74c-19b0-48b9-9974-70dd49706cbb</MobileKeySetId>
      </EncryptedCredentialData>
      <EncryptedCredentialData>
        <EncryptedCredential>sample string 3</EncryptedCredential>
        <KeyIndex>2</KeyIndex>
        <MobileKeySetId>8932c74c-19b0-48b9-9974-70dd49706cbb</MobileKeySetId>
      </EncryptedCredentialData>
    </EncryptedMobileCredentials>
    <ExternalCardNumber>sample string 8</ExternalCardNumber>
    <FacilityCode>9</FacilityCode>
    <HidInvitationCode>sample string 13</HidInvitationCode>
    <InternalCardNumber>7</InternalCardNumber>
    <InvitationRedeemedDateTime>2025-12-13T00:03:14.3963687+00:00</InvitationRedeemedDateTime>
    <IssueCode>10</IssueCode>
    <PIN>sample string 11</PIN>
    <PersonCardId>e9597bd7-11ed-4cc5-94c9-a84da5c0456a</PersonCardId>
  </Card>
  <DateExpected>2025-12-13T00:03:14.3963687+00:00</DateExpected>
  <DateTimeArrived>2025-12-13T00:03:14.3963687+00:00</DateTimeArrived>
  <Deleted>true</Deleted>
  <FirstName>sample string 4</FirstName>
  <GroupHashTag>sample string 11</GroupHashTag>
  <GuestCompany>sample string 7</GuestCompany>
  <HostPersonId>83c77f17-cf76-46bb-af9d-d63e0fe26a59</HostPersonId>
  <LastName>sample string 5</LastName>
  <Message>sample string 9</Message>
  <MiddleInitial>sample string 6</MiddleInitial>
  <VisitorRequestId>6fd1c07a-5871-48d8-8e87-2e1a173ea81d</VisitorRequestId>
  <VisitorRequestInstanceId>98d8b7d3-ef5b-4abd-8291-fb9e5a7a14a5</VisitorRequestInstanceId>
  <VisitorStatus>NotCheckedIn</VisitorStatus>
  <sVisitorTypeId>0d43a8f4-66e0-4285-986d-4b57732eb6b0</sVisitorTypeId>
</VisitorRequestInstanceViewModel>