Page Comparison

Excerpt

Description

If you wish to get the details of a specific user that is registered with WSO2 EMM, you can do so using the REST API.

Resource Path /

URL /mdm-admin/users/view?username={username}

HTTP Method GET

Request/Response Format application/json

cURL command

Code Block
curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/users/view?username={username}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
Provide the name of the user you wish to get the details of as the value for {username}. If you are unsure of the exact user name, run the REST API command to retrieve all the user details to find out the username.

Example:

Code Block
curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/users/view?username=kim

Sample output

Code Block

> GET /mdm-admin/users/view?username=kim HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
> 
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Fri, 04 Mar 2016 09:35:51 GMT
< Content-Type: application/json
< Content-Length: 188
< Server: WSO2 Carbon Server
{"statusCode":200,"messageFromServer":"User information was retrieved successfully.","responseContent":{"username":"kim","firstname":"Kim","lastname":"Bar","emailAddress":"kim@gmail.com"}}

Sample JSON Output Definition

Code Block
{ "username":"kim", "firstname":"Kim", "lastname":"Bar", "emailAddress":"kim@gmail.com" }

Property	Definition
`username`	Defines the username of the user.
`firstname`	Defines the first name of the user.
`lastname`	Defines the last name of the user.
`emailAddress`	Defines the email address of the user.

Versions Compared

Old Version 2

New Version Current

Key