GET api/v2/Users/UserCards?UserId={UserId}&IncludeDeleted={IncludeDeleted}&FacilityCode={FacilityCode}
Returns list of cards for a given user by the UserId
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| UserId | globally unique identifier |
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": "a0e00d57-d2fd-41f2-83a2-a82621337d9e",
"Cards": [
{
"NumberOfCardUses": 1,
"PublicNotes": "sample string 1",
"PersonCardId": "821d5e9b-fb25-4e5b-a943-2e653091627c",
"CardName": "sample string 3",
"CardId": "b5c11ef1-3a0e-4d1d-9f8f-499bfb8ba1b2",
"CardType": 5,
"CardACSystemId": "5b07b2ea-d13a-4f45-8195-9dc8f96b1cef",
"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": "2025-10-22T03:41:34.3283562+00:00",
"DateInserted": "2025-10-22T03:41:34.3283562+00:00",
"DateUpdated": "2025-10-22T03:41:34.3283562+00:00",
"CardActivationStartDateTime": "2025-10-22T03:41:34.3283562+00:00",
"CardDeactivationStartDateTime": "2025-10-22T03:41:34.3283562+00:00",
"CardUserFlags": 1,
"EncryptedMobileCredentials": [
{
"MobileKeySetId": "eb0aef23-a6d5-4507-91e5-41478b990bd7",
"KeyIndex": 2,
"EncryptedCredential": "sample string 3"
},
{
"MobileKeySetId": "eb0aef23-a6d5-4507-91e5-41478b990bd7",
"KeyIndex": 2,
"EncryptedCredential": "sample string 3"
}
],
"CredentialType": 1
},
{
"NumberOfCardUses": 1,
"PublicNotes": "sample string 1",
"PersonCardId": "821d5e9b-fb25-4e5b-a943-2e653091627c",
"CardName": "sample string 3",
"CardId": "b5c11ef1-3a0e-4d1d-9f8f-499bfb8ba1b2",
"CardType": 5,
"CardACSystemId": "5b07b2ea-d13a-4f45-8195-9dc8f96b1cef",
"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": "2025-10-22T03:41:34.3283562+00:00",
"DateInserted": "2025-10-22T03:41:34.3283562+00:00",
"DateUpdated": "2025-10-22T03:41:34.3283562+00:00",
"CardActivationStartDateTime": "2025-10-22T03:41:34.3283562+00:00",
"CardDeactivationStartDateTime": "2025-10-22T03:41:34.3283562+00:00",
"CardUserFlags": 1,
"EncryptedMobileCredentials": [
{
"MobileKeySetId": "eb0aef23-a6d5-4507-91e5-41478b990bd7",
"KeyIndex": 2,
"EncryptedCredential": "sample string 3"
},
{
"MobileKeySetId": "eb0aef23-a6d5-4507-91e5-41478b990bd7",
"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>5b07b2ea-d13a-4f45-8195-9dc8f96b1cef</CardACSystemId>
<CardACSystemName>sample string 7</CardACSystemName>
<CardActivationStartDateTime>2025-10-22T03:41:34.3283562+00:00</CardActivationStartDateTime>
<CardDeactivationStartDateTime>2025-10-22T03:41:34.3283562+00:00</CardDeactivationStartDateTime>
<CardId>b5c11ef1-3a0e-4d1d-9f8f-499bfb8ba1b2</CardId>
<CardName>sample string 3</CardName>
<CardSerialNumber>1</CardSerialNumber>
<CardType>5</CardType>
<CardUserFlags>ActiveCardholderRecord</CardUserFlags>
<CredentialType>Proximity</CredentialType>
<DateInserted>2025-10-22T03:41:34.3283562+00:00</DateInserted>
<DateUpdated>2025-10-22T03:41:34.3283562+00:00</DateUpdated>
<EncryptedMobileCredentials>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>eb0aef23-a6d5-4507-91e5-41478b990bd7</MobileKeySetId>
</EncryptedCredentialData>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>eb0aef23-a6d5-4507-91e5-41478b990bd7</MobileKeySetId>
</EncryptedCredentialData>
</EncryptedMobileCredentials>
<ExternalCardNumber>sample string 9</ExternalCardNumber>
<FacilityCode>10</FacilityCode>
<HidInvitationCode>sample string 14</HidInvitationCode>
<InternalCardNumber>8</InternalCardNumber>
<InvitationRedeemedDateTime>2025-10-22T03:41:34.3283562+00:00</InvitationRedeemedDateTime>
<IssueCode>11</IssueCode>
<PIN>sample string 12</PIN>
<PersonCardId>821d5e9b-fb25-4e5b-a943-2e653091627c</PersonCardId>
<NumberOfCardUses>1</NumberOfCardUses>
<PublicNotes>sample string 1</PublicNotes>
</PersonCardViewModelV2>
<PersonCardViewModelV2>
<CardACSystemId>5b07b2ea-d13a-4f45-8195-9dc8f96b1cef</CardACSystemId>
<CardACSystemName>sample string 7</CardACSystemName>
<CardActivationStartDateTime>2025-10-22T03:41:34.3283562+00:00</CardActivationStartDateTime>
<CardDeactivationStartDateTime>2025-10-22T03:41:34.3283562+00:00</CardDeactivationStartDateTime>
<CardId>b5c11ef1-3a0e-4d1d-9f8f-499bfb8ba1b2</CardId>
<CardName>sample string 3</CardName>
<CardSerialNumber>1</CardSerialNumber>
<CardType>5</CardType>
<CardUserFlags>ActiveCardholderRecord</CardUserFlags>
<CredentialType>Proximity</CredentialType>
<DateInserted>2025-10-22T03:41:34.3283562+00:00</DateInserted>
<DateUpdated>2025-10-22T03:41:34.3283562+00:00</DateUpdated>
<EncryptedMobileCredentials>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>eb0aef23-a6d5-4507-91e5-41478b990bd7</MobileKeySetId>
</EncryptedCredentialData>
<EncryptedCredentialData>
<EncryptedCredential>sample string 3</EncryptedCredential>
<KeyIndex>2</KeyIndex>
<MobileKeySetId>eb0aef23-a6d5-4507-91e5-41478b990bd7</MobileKeySetId>
</EncryptedCredentialData>
</EncryptedMobileCredentials>
<ExternalCardNumber>sample string 9</ExternalCardNumber>
<FacilityCode>10</FacilityCode>
<HidInvitationCode>sample string 14</HidInvitationCode>
<InternalCardNumber>8</InternalCardNumber>
<InvitationRedeemedDateTime>2025-10-22T03:41:34.3283562+00:00</InvitationRedeemedDateTime>
<IssueCode>11</IssueCode>
<PIN>sample string 12</PIN>
<PersonCardId>821d5e9b-fb25-4e5b-a943-2e653091627c</PersonCardId>
<NumberOfCardUses>1</NumberOfCardUses>
<PublicNotes>sample string 1</PublicNotes>
</PersonCardViewModelV2>
</Cards>
<UserId>a0e00d57-d2fd-41f2-83a2-a82621337d9e</UserId>
</PersonCardAndUserIdViewModelV2>