Find department

GET

/v3/departments/lookup

Match departments by the entered department name and return the department ID and name.

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/departments/lookup?name=undefined' \
--header 'HAP-Appkey;' \
--header 'HAP-Sign;'

Responses

🟢200OK

application/json

Department found successfully

Bodyapplication/json

Example

{
    "data": {
        "departments": [
            {
                "id": "7fb381a3-d559-4b0c-a8fd-e1e8a6272442",
                "name": "Sales Department 1",
                "path": "华东大区/上海分公司/销售部",
                "pathNodes": [
                    {
                        "id": "dep_000",
                        "name": "East China region"
                    },
                    {
                        "id": "dep_001",
                        "name": "Shanghai branch"
                    },
                    {
                        "id": "dep_002",
                        "name": "Sales Department"
                    }
                ]
            }
        ]
    },
    "success": true
}

Modified at 2026-04-15 09:20:35

Find member

Get region information