GET api/v2/Users/UserCards?EmailAddress={EmailAddress}&IncludeDeleted={IncludeDeleted}&FacilityCode={FacilityCode}

Returns list of cards for a given user by the User Email Address

Request Information

URI Parameters

Name	Type	Additional information
EmailAddress	string	Required
IncludeDeleted	boolean	Default value is False
FacilityCode	integer	Default value is -1

Body Parameters

None.

Response Information

Resource Description

PersonCardAndUserIdViewModelV2

Name	Description	Type	Additional information
UserId		globally unique identifier	None.
Cards		Collection of PersonCardViewModelV2	None.

Response Formats

application/json, text/json

Sample:

{
  "UserId": "a38c3d83-0eaa-49ad-a99c-88fac03e4219",
  "Cards": [
    {
      "NumberOfCardUses": 1,
      "PublicNotes": "sample string 1",
      "PersonCardId": "719d78da-8760-4827-b5d2-639c8a32e9cb",
      "CardName": "sample string 3",
      "CardId": "a0fe7860-ac23-48a3-8c56-3d10b7307c5e",
      "CardType": 5,
      "CardACSystemId": "fdfb6351-47dd-4c4c-a324-1d325e1fcc3e",
      "CardACSystemName": "sample string 7",
      "InternalCardNumber": 8,
      "ExternalCardNumber": "sample string 9",
      "CardSerialNumber": 1,
      "FacilityCode": 10,
      "IssueCode": 11,
      "PIN": "sample string 12",
      "Deleted": true,
      "HidInvitationCode": "sample string 14",
      "InvitationRedeemedDateTime": "2026-04-29T15:41:42.5894519+00:00",
      "DateInserted": "2026-04-29T15:41:42.5894519+00:00",
      "DateUpdated": "2026-04-29T15:41:42.5894519+00:00",
      "CardActivationStartDateTime": "2026-04-29T15:41:42.5894519+00:00",
      "CardDeactivationStartDateTime": "2026-04-29T15:41:42.5894519+00:00",
      "CardUserFlags": 1,
      "EncryptedMobileCredentials": [
        {
          "MobileKeySetId": "791e2114-c89f-470b-b1a1-75e2d2fd9e33",
          "KeyIndex": 2,
          "EncryptedCredential": "sample string 3"
        },
        {
          "MobileKeySetId": "791e2114-c89f-470b-b1a1-75e2d2fd9e33",
          "KeyIndex": 2,
          "EncryptedCredential": "sample string 3"
        }
      ],
      "CredentialType": 1
    },
    {
      "NumberOfCardUses": 1,
      "PublicNotes": "sample string 1",
      "PersonCardId": "719d78da-8760-4827-b5d2-639c8a32e9cb",
      "CardName": "sample string 3",
      "CardId": "a0fe7860-ac23-48a3-8c56-3d10b7307c5e",
      "CardType": 5,
      "CardACSystemId": "fdfb6351-47dd-4c4c-a324-1d325e1fcc3e",
      "CardACSystemName": "sample string 7",
      "InternalCardNumber": 8,
      "ExternalCardNumber": "sample string 9",
      "CardSerialNumber": 1,
      "FacilityCode": 10,
      "IssueCode": 11,
      "PIN": "sample string 12",
      "Deleted": true,
      "HidInvitationCode": "sample string 14",
      "InvitationRedeemedDateTime": "2026-04-29T15:41:42.5894519+00:00",
      "DateInserted": "2026-04-29T15:41:42.5894519+00:00",
      "DateUpdated": "2026-04-29T15:41:42.5894519+00:00",
      "CardActivationStartDateTime": "2026-04-29T15:41:42.5894519+00:00",
      "CardDeactivationStartDateTime": "2026-04-29T15:41:42.5894519+00:00",
      "CardUserFlags": 1,
      "EncryptedMobileCredentials": [
        {
          "MobileKeySetId": "791e2114-c89f-470b-b1a1-75e2d2fd9e33",
          "KeyIndex": 2,
          "EncryptedCredential": "sample string 3"
        },
        {
          "MobileKeySetId": "791e2114-c89f-470b-b1a1-75e2d2fd9e33",
          "KeyIndex": 2,
          "EncryptedCredential": "sample string 3"
        }
      ],
      "CredentialType": 1
    }
  ]
}

application/xml, text/xml

Sample:

<PersonCardAndUserIdViewModelV2 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <Cards>
    <PersonCardViewModelV2>
      <CardACSystemId>fdfb6351-47dd-4c4c-a324-1d325e1fcc3e</CardACSystemId>
      <CardACSystemName>sample string 7</CardACSystemName>
      <CardActivationStartDateTime>2026-04-29T15:41:42.5894519+00:00</CardActivationStartDateTime>
      <CardDeactivationStartDateTime>2026-04-29T15:41:42.5894519+00:00</CardDeactivationStartDateTime>
      <CardId>a0fe7860-ac23-48a3-8c56-3d10b7307c5e</CardId>
      <CardName>sample string 3</CardName>
      <CardSerialNumber>1</CardSerialNumber>
      <CardType>5</CardType>
      <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
      <CredentialType>Proximity</CredentialType>
      <DateInserted>2026-04-29T15:41:42.5894519+00:00</DateInserted>
      <DateUpdated>2026-04-29T15:41:42.5894519+00:00</DateUpdated>
      <EncryptedMobileCredentials>
        <EncryptedCredentialData>
          <EncryptedCredential>sample string 3</EncryptedCredential>
          <KeyIndex>2</KeyIndex>
          <MobileKeySetId>791e2114-c89f-470b-b1a1-75e2d2fd9e33</MobileKeySetId>
        </EncryptedCredentialData>
        <EncryptedCredentialData>
          <EncryptedCredential>sample string 3</EncryptedCredential>
          <KeyIndex>2</KeyIndex>
          <MobileKeySetId>791e2114-c89f-470b-b1a1-75e2d2fd9e33</MobileKeySetId>
        </EncryptedCredentialData>
      </EncryptedMobileCredentials>
      <ExternalCardNumber>sample string 9</ExternalCardNumber>
      <FacilityCode>10</FacilityCode>
      <HidInvitationCode>sample string 14</HidInvitationCode>
      <InternalCardNumber>8</InternalCardNumber>
      <InvitationRedeemedDateTime>2026-04-29T15:41:42.5894519+00:00</InvitationRedeemedDateTime>
      <IssueCode>11</IssueCode>
      <PIN>sample string 12</PIN>
      <PersonCardId>719d78da-8760-4827-b5d2-639c8a32e9cb</PersonCardId>
      <NumberOfCardUses>1</NumberOfCardUses>
      <PublicNotes>sample string 1</PublicNotes>
    </PersonCardViewModelV2>
    <PersonCardViewModelV2>
      <CardACSystemId>fdfb6351-47dd-4c4c-a324-1d325e1fcc3e</CardACSystemId>
      <CardACSystemName>sample string 7</CardACSystemName>
      <CardActivationStartDateTime>2026-04-29T15:41:42.5894519+00:00</CardActivationStartDateTime>
      <CardDeactivationStartDateTime>2026-04-29T15:41:42.5894519+00:00</CardDeactivationStartDateTime>
      <CardId>a0fe7860-ac23-48a3-8c56-3d10b7307c5e</CardId>
      <CardName>sample string 3</CardName>
      <CardSerialNumber>1</CardSerialNumber>
      <CardType>5</CardType>
      <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
      <CredentialType>Proximity</CredentialType>
      <DateInserted>2026-04-29T15:41:42.5894519+00:00</DateInserted>
      <DateUpdated>2026-04-29T15:41:42.5894519+00:00</DateUpdated>
      <EncryptedMobileCredentials>
        <EncryptedCredentialData>
          <EncryptedCredential>sample string 3</EncryptedCredential>
          <KeyIndex>2</KeyIndex>
          <MobileKeySetId>791e2114-c89f-470b-b1a1-75e2d2fd9e33</MobileKeySetId>
        </EncryptedCredentialData>
        <EncryptedCredentialData>
          <EncryptedCredential>sample string 3</EncryptedCredential>
          <KeyIndex>2</KeyIndex>
          <MobileKeySetId>791e2114-c89f-470b-b1a1-75e2d2fd9e33</MobileKeySetId>
        </EncryptedCredentialData>
      </EncryptedMobileCredentials>
      <ExternalCardNumber>sample string 9</ExternalCardNumber>
      <FacilityCode>10</FacilityCode>
      <HidInvitationCode>sample string 14</HidInvitationCode>
      <InternalCardNumber>8</InternalCardNumber>
      <InvitationRedeemedDateTime>2026-04-29T15:41:42.5894519+00:00</InvitationRedeemedDateTime>
      <IssueCode>11</IssueCode>
      <PIN>sample string 12</PIN>
      <PersonCardId>719d78da-8760-4827-b5d2-639c8a32e9cb</PersonCardId>
      <NumberOfCardUses>1</NumberOfCardUses>
      <PublicNotes>sample string 1</PublicNotes>
    </PersonCardViewModelV2>
  </Cards>
  <UserId>a38c3d83-0eaa-49ad-a99c-88fac03e4219</UserId>
</PersonCardAndUserIdViewModelV2>