Add Address

Add Address API will add the address for the requested user.

Resource Informations

Name	Value
Requires authentication?	Yes
Rate limited?	No

Request

Request headers

Key	Value
Authorization	Bearer token
Content-Type	application/json

HTTP request URL

POST https://{hostname}/auth/realms/{tenantId}/address/{userName}/add

note

Digitanium support for this API will be provided on request.

note

API requests must be made over https. Calls made over plain http will fail.

Parameters

No parameters fields are required.

Request body(*Required)

Field Name	Type	Description
firstName	String	firstName of the user.
lastName	String	lastName of the user.
addressType	String	Define the place of the address.
addressTitle	String	Define the title given to the respective address.
city	String	Define the city given for the address.
cityCode	String	Define the cityCode given for the location.
town	String	Define the town the address is located.
townCode	String	Define the townCode the address is located.
district	String	Define the district the address is located.
districtCode	String	Define the districtCode the address is located.
addressDetails	String	Describe the details related to the address.
*postalCode	String	Define the postalCode of the given address.
directions	String	Provide the direction for the address.
defaultAddress	Boolean	The configured default address will be taken, if true.

Sample Request

{
    "firstName" : "mark",
    "lastName" : "jay",
    "addressType" : "Home",
    "addressTitle" : "Home address",
    "city" : "scotland",
    "cityCode" : "625531",
    "town" : "hometown",
    "townCode" : "625521",
    "district" : "glasgow",
    "districtCode" : "123456",
    "addressDetails" : "addressDetails",
    "postalCode" : "654321", 
    "directions" : "",
    "defaultAddress" : true
}

Response

Field Name	Type	Description
message	String	Message explains result of the API call. Refer Response status Information for details.
status	String	The status of the API call. Refer Response status Information for details.
subSystem	Integer	subSystem categorizes the type of API that has been called. Refer Subsystem details for details.

Sample Response

{
    "message": "Address added successfully",
    "status": "Success",
    "subSystem": 5
}

Response Status Information

Status Code	Status	Message
200	OK	Address added successfully
400	BAD_REQUEST	Mandatory data is missing
401	Unauthorized	HTTP 401 Unauthorized
404	USER_NOT_FOUND	User does not exist