Member Retrieval (Recursively) APIAPI Explorer

Introduction

API Introduction

Member Retrieval API (Recursively) enables you to recursively obtain all members under a specified department ID.

API Calling

The API enables you to recursively obtain all members under a specified department ID.

Request URL: https://api.jodoo.com/api/v5/corp/department/user/list

Request Frequency: 10 times/second

Request Method: POST

Request Parameters:

Parameter

Type

Required

Description

dept_no

number

Yes

Department number

has_child

Boolean

No

The system is set not to recursively obtain all members. That is, you can only obtain the members in the current department instead of those in other sub-departments.

Sample Request:

{
   "dept_no":1,
  "has_child": true
}

Sample Response:

Parameter

Description

users

The list of members in the currently specified department

The returned data structure for one member could be as follows:

Parameter

Description

Notes

name

Nickname

The name of members can be duplicated, and members with the same name will have the same 'name' value.

username

Username

Within a company, the username is unique, but there may be duplicates across different companies.

departments

The department list of users

/

type

Department type

0: regular department

status

Department status

1: department in use

Sample Response:

{
  "users": [
    {
      "username": "aubrey",
      "name": "aubrey",
      "departments": [1],
      "type": 0,
      "status": 1
    }
  ]
}

Was this information helpful?
Yes
NoNo
Need more help? Contact support