IDaaS Open Platform
Employee Identity (EIAM)

Get User Details by Email

API

# Permissions

The Identity Management APIs are authorized at the application dimension. Before calling the APIs, you need to set API permissions for different applications. For details, please refer to API Permissions.

Permission Code Description
user_all Read and write permissions for user management APIs
user_read Read permissions for user management APIs
all Read and write permissions for all APIs
read Permissions for all read APIs

# Request Description

POST https://{your_domain}/api/v2/tenant/users/user-by-email

# Request Headers

Parameter Name Chinese Name Required Type Description
Authorization Authorization Yes String Format: Bearer {access_token}
Content-Type Content Type Yes String Fixed value: application/json; charset=utf-8

# Request Example

{
    "email":"xxxxx@bamboocloud.com"
}
1
2
3

# Request Parameters

Parameter Name Chinese Name Required Type Description
email User Email Yes String

# Return Example

Correct Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
    "user_id": "20220825141325371-4D03-81EF80243",
    "org_id": "20210529172248496-D329-5748DE918",
    "user_name": "cq04130007",
    "name": "cq04130007",
    "mobile": "+86-xxxxxx",
    "email": "xxxxx@example.com",
    "first_name": "F",
    "middle_name": "M",
    "last_name": "L",
    "employee_id": "041300071",
    "external_id": "041300071",
    "attr_city": "Wuhan",
    "attr_nick_name": "cq04130007",
    "attr_area": "CN",
    "attr_gender": "male",
    "attr_work_place": "Wuhan",
    "attr_identity_type": "id_card",
    "attr_identity_number": "420100199911111111",
    "attr_manager_id": "20210601223953060-2AEC-D22770B77",
    "attr_birthday": "1993-08-25 00:00:00.000",
    "attr_user_type": "20211124152258971-9F54-3B43283CC",
    "attr_hire_date": "2022-08-01 00:00:00.000",
    "pwd_must_modify": false,
    "disabled": false,
    "locked": false,
    "grade": 1,
    "created_at": "2022-08-25 14:13:25.372",
    "updated_at": "2022-08-25 14:37:24.610",
    "last_login_ip": "120.46.143.105",
    "last_login_at": "2024-06-06 15:14:28.000",
    "user_org_relation_list": [
        {
            "org_id": "20220221173529886-B8BB-9F404BCDE",
            "relation_type": 0
        },
        {
            "org_id": "20210529172248496-D329-5748DE918",
            "relation_type": 1
        }
    ],
    "extension": {}
}


Error Example:
HTTP/1.1 400 Bad Request
{
  "error_msg": "User does not exist",
  "error_code": "USER.0001"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# Return Parameters

Parameter Name Chinese Name Type Description
user_id User ID String
org_id Organization ID String
user_name Username String
name Name String
mobile Mobile Number String
email Email String
first_name First Name String
middle_name Middle Name String
last_name Last Name String
employee_id Employee ID String
external_id External System ID String
attr_gender Gender String
attr_birthday Birthday String
attr_nick_name Nickname String
attr_identity_type Identity Document Type String
attr_identity_number Identity Document Number String
attr_area Country or Region String
attr_city City String
attr_manager_id Direct Supervisor String Supervisor's User ID
attr_user_type Personnel Type String Type ID
attr_hire_date Hire Date String
attr_work_place Work Location String
pwd_change_at Password Change Time String
created_at User Creation Time String
updated_at User Modification Time String
last_login_ip Last Login IP String
last_login_at Last Login Time String
disabled Whether Disabled String
grade Trust Level Int
locked Locked Boolean
extension Extended Attributes JSONObject
user_org_relation_list User-Organization Relation Collection List
--job_id Relation ID String
--org_id Organization ID String
--relation_type Relation Type int 1 for Belonging, 0 for Affiliation
jobs User Job Position Collection List Returned when tenant enables position management
--job_id Job Position ID String
--org_id Organization ID String
--position_id Position ID String
--title_id Title ID String
--relation_type Job Position Type String 1 for Primary Position, 0 for Concurrent/Part-time Position

# Error Codes

Status Code Error Code Error Message Action
400 USER.0001 User does not exist Please check if the corresponding user exists

Get All Authorized Application Accounts