POST api/v1/Users/{id}/UserCards

Adds a Card to an existing User. Returns Success/Error code plus primary key of UserCard entry made.

Request Information

URI Parameters

Name	Description	Type	Additional information
id		string	None.

Body Parameters

AddUserCardViewModel

Name	Description	Type	Additional information
ReassignCardIfAlreadyAssigned	Optional. If true, deletes current card assignment (if any) for a given card before assigning it to the given User	boolean	None.
UserId	Required: The PK of the existing User that you want to add the card to.	globally unique identifier	None.
CardId	Optional: The PK of an existing card that you want to assign to the User. Retrieve possible values from /Card/GetAllCards. If null, CardType, CardACSystem, InternalCardNumber, ExternalCardNumber and Facility code are required.	globally unique identifier	None.
CardType	Conditional: If CardId is null, this is required. Represents the type of card being added dynamically. Retrieve possible values from /Card/GetAllCardTypes	integer	None.
CardACSystemId	Conditional: If CardId is null, this is required. Represents the Access Control System of the card being added dynamically. Retrieve possible values from /ACSystem/GetAllSystems	globally unique identifier	None.
InternalCardNumber	Conditional: If CardId is null, this is required. Represents the internal/encoded number of the card being added dynamically.	integer	None.
ExternalCardNumber	Conditional: If CardId is null, this is required. Represents the external number printed on the card being added dynamically.	string	None.
CardSerialNumber	Conditional: If CardType supports it, this is required. Represents the serial number of the smart card being added dynamically.	integer	None.
FacilityCode	Conditional: If CardType supports it, this is required. Represents the facility code of the smart card being added dynamically.	integer	None.
IssueCode	Conditional: If CardType supports it, this is required. Represents the issue code of the smart card being added dynamically.	integer	None.
PIN	Optional: The PIN that the User may use in conjunction with this Card for Card + PIN mode or for when Readers are in PIN mode only.	string	None.
EnforceOccupancySystem	Optional: Requests to verify if the CardACSystemId matches the system the User's Occupancy belongs to	boolean	None.
CardActivationStartDateTime	Optional: Date and time of the card activation	date	None.
CardDeactivationStartDateTime	Optional: Date and time of the card de-activation	date	None.
CardUserFlags	Card User Flags	CardUserFlags	None.

Request Formats

application/json, text/json

Sample:

{
  "ReassignCardIfAlreadyAssigned": true,
  "UserId": "867ff3cd-fc90-4fc4-9d13-fb6331ce6796",
  "CardId": "52d914df-b041-4ed9-9fdc-c20a7586fb45",
  "CardType": 3,
  "CardACSystemId": "b00a1c79-e52a-44db-b9d6-57eebe8157cc",
  "InternalCardNumber": 4,
  "ExternalCardNumber": "sample string 5",
  "CardSerialNumber": 1,
  "FacilityCode": 1,
  "IssueCode": 1,
  "PIN": "sample string 6",
  "EnforceOccupancySystem": true,
  "CardActivationStartDateTime": "2025-11-19T20:46:18.2428057+00:00",
  "CardDeactivationStartDateTime": "2025-11-19T20:46:18.2428057+00:00",
  "CardUserFlags": 1
}

application/xml, text/xml

Sample:

<AddUserCardViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <CardACSystemId>b00a1c79-e52a-44db-b9d6-57eebe8157cc</CardACSystemId>
  <CardActivationStartDateTime>2025-11-19T20:46:18.2428057+00:00</CardActivationStartDateTime>
  <CardDeactivationStartDateTime>2025-11-19T20:46:18.2428057+00:00</CardDeactivationStartDateTime>
  <CardId>52d914df-b041-4ed9-9fdc-c20a7586fb45</CardId>
  <CardSerialNumber>1</CardSerialNumber>
  <CardType>3</CardType>
  <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
  <EnforceOccupancySystem>true</EnforceOccupancySystem>
  <ExternalCardNumber>sample string 5</ExternalCardNumber>
  <FacilityCode>1</FacilityCode>
  <InternalCardNumber>4</InternalCardNumber>
  <IssueCode>1</IssueCode>
  <PIN>sample string 6</PIN>
  <UserId>867ff3cd-fc90-4fc4-9d13-fb6331ce6796</UserId>
  <ReassignCardIfAlreadyAssigned>true</ReassignCardIfAlreadyAssigned>
</AddUserCardViewModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResultWithGuid

Name	Description	Type	Additional information
Value	Represents the PK value that was created as a result of an add	globally unique identifier	None.
ResultCode	Represents the result code	integer	None.
Description	Represents a description of the result code	string	None.

Response Formats

application/json, text/json

Sample:

{
  "Value": "3f0474e1-2f9f-4b24-a2a1-88543f2368aa",
  "ResultCode": 2,
  "Description": "sample string 3"
}

application/xml, text/xml

Sample:

<ResultWithGuid xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <Description>sample string 3</Description>
  <HttpStatusCode>Continue</HttpStatusCode>
  <ResultCode>2</ResultCode>
  <Value>3f0474e1-2f9f-4b24-a2a1-88543f2368aa</Value>
</ResultWithGuid>