Find member

GET

/v3/users/lookup

Match users by the entered person name, and return user ID, name, masked mobile number, and email.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.nocoly.com/v3/users/lookup?name=undefined&orgId=Organization%20id%0AWhen%20using%20AppKey+Sign%20Not%20required%20when%20authenticating%20with%20AppKey.%20Returns%20department%20information%20for%20the%20organization%20that%20owns%20the%20app.%20Required%20when%20authenticating%20with%20a%20personal%20access%20token%20(PAT)%20%2F%20oauth.%20Pass%20the%20organization%20ID%20to%20query%20and%20return%20department%20information%20for%20the%20corresponding%20organization.' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}'

Responses

🟢200Success

application/json

Members found successfully

Bodyapplication/json

Example

{
    "data": {
        "users": [
            {
                "accountId": "user_001",
                "name": "Alice",
                "mobile": "138****5678",
                "email": "ali****@mail.com",
                "departments": [
                    {
                        "id": "dep_001",
                        "name": "Department A",
                        "path": "Company/Department A",
                        "pathNodes": [
                            {
                                "id": "dep_000",
                                "name": "Company"
                            },
                            {
                                "id": "dep_001",
                                "name": "Department A"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "success": true
}

Modified at 2026-06-25 10:21:06

Disable option set

Find department