Get Role

Description: 

This API is use to Retrieve list of roles or details of specific Role when role name is given.

API Endpoint: 

/ws/userrolemanagement

Method: 

POST

Header: 

Request:

Request Example: 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:user="http://www.elegantjbi.com/ws/userrolemanagement">

   <soapenv:Header>

      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

         <wsse:UsernameToken wsu:Id="UsernameToken-6F3698DD06BD1DF26C16959684003652">

            <wsse:Username>username</wsse:Username>

            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">password</wsse:Password>

         </wsse:UsernameToken>

      </wsse:Security>

   </soapenv:Header>

   <soapenv:Body>

      <user:getRolesRequest>

         <roleName>roleName</roleName>

      </user:getRolesRequest>

   </soapenv:Body>

</soapenv:Envelope>

Response: 

Return a response with SOAP XML as object. 

Response Example: 

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

    <SOAP-ENV:Header>

        <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" SOAP-ENV:mustUnderstand="1">

            <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="XWSSGID-1747337693638-1069532304">

                <wsse:Username>user</wsse:Username>

                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">+U5qb1+6cabvE+SOTeAwRjd+vGM=</wsse:Password>

                <wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">NZEY8eavB1/PKGrcTSkK515a</wsse:Nonce>

                <wsu:Created>2025-06-03T13:16:34.800Z</wsu:Created>

            </wsse:UsernameToken>

        </wsse:Security>

    </SOAP-ENV:Header>

    <SOAP-ENV:Body>

        <ns3:getRolesResponse xmlns:ns3="http://www.elegantjbi.com/ws/userrolemanagement">

            <status>

                <statusCode>Success</statusCode>

            </status>

            <roles>

                <roleId>roleId</roleId>

                <roleName>roleName</roleName>

                <roleDesc/>

            </roles>

        </ns3:getRolesResponse>

    </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Postman Example: 

You can import the example below into Postman. 

curl --location 'https://demo.smarten.com/smarten/ws/RoleManagementService' \

--header 'Content-Type: text/xml' \

--header 'Cookie: JSESSIONID=EtzEQQbsvBwacW1IovMoH2HB0_8ZK8LgiCDHrYgL.ip-172-31-8-13' \

--data '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:user="http://www.elegantjbi.com/ws/userrolemanagement">

   <soapenv:Header>

      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

         <wsse:UsernameToken wsu:Id="UsernameToken-6F3698DD06BD1DF26C16959684003652">

            <wsse:Username>username</wsse:Username>

            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">password</wsse:Password>

         </wsse:UsernameToken>

      </wsse:Security>

   </soapenv:Header>

   <soapenv:Body>

      <user:getRolesRequest>

         <roleName>roleName</roleName>

      </user:getRolesRequest>

   </soapenv:Body>

</soapenv:Envelope>'