# Retrieve account and role details for the currently authenticated user

Returns the user account and role details for the currently authenticated user. Exempt from strict role-based access control; accessible before sign-up completion in cloud flows.

## Endpoints

`GET /dcapi/uac/userMeta`

## Request URL

https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/uac/userMeta

## Scope

`DesktopCentralCloud.Common.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **accept** `string` **Mandatory**
  - `application/userMeta.v1+json`
  - Specifies the expected response format. Set to application/userMeta.v1+json to receive the user meta response in JSON format.

## Sample Request

### Curl

```curl
curl --request GET \
  --url https://appdomains/dcapi/uac/userMeta \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'accept: application/userMeta.v1+json'
```

### Java

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomains/dcapi/uac/userMeta"))
        .header("accept", "application/userMeta.v1+json")
        .header("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse<string> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());

  }
}
</string>
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("appdomains")

headers = {
    'accept': "application/userMeta.v1+json",
    'Authorization': "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("GET", "/dcapi/uac/userMeta", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
```

### Deluge

```javascript
headersMap = Map();
headersMap.put("accept", "application/userMeta.v1+json");

response = invokeUrl
[
    url: "https://appDomains/dcapi/uac/userMeta"
    type: GET
    headers: headersMap
    connection: connection_name
]

info response;
```

### PowerShell

```powershell
$headers=@{}
$headers.Add("accept", "application/userMeta.v1+json")
$headers.Add("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomains/dcapi/uac/userMeta' -Method GET -Headers $headers
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

`JSON Object`

- **loginID** `string`
  - Unique login identifier for the authenticated user.
- **userName** `string`
  - Username of the authenticated user.
- **mailID** `string`
  - Email address of the user account.
- **roleID** `string`
  - Unique identifier of the role assigned to the user.
- **roleName** `string`
  - Name of the role assigned to the user.
- **isSuperAdmin** `boolean`
  - Indicates whether the user has super-administrator privileges.
- **computerScopeType** `integer`
  - Computer scope type assigned to the user (0 = All computers, 1 = Custom scope).
- **isSDPUser** `boolean`
  - Indicates whether the user is associated with the Software Deployment Platform (SDP).
- **accountType** `string`
  - Account type for the user (e.g., local, ad).
- **loginName** `string`
  - Display name of the user as shown in the console.

### Sample Response: HTTP 200

User account and role details for the currently authenticated user.

```json
{
  "computerScopeType": 0,
  "loginID": "9502000000122681",
  "roleID": "9502000000014452",
  "isSDPUser": false,
  "accountType": "local",
  "loginName": "Alex Morgan",
  "roleName": "Administrator",
  "mailID": "alex.morgan@example.com",
  "isSuperAdmin": false,
  "userName": "alex.morgan"
}
```

## Possible Response Codes

- **200** `HTTP code`

## Rate Limit

![Help icon](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 60 | **Lock period:** 5 minutes

Duration — Time window for the threshold.  
Threshold — Number of API calls allowed within the specified duration.  
Lock Period — Wait time before consecutive API requests.