## Employees in several departments

`POST /v1/humanresources/employees/multidepartment`

Returns employees who belong to several departments of the organizational structure at once. Only those with two or more departments are included in the output, and every department is listed for each of them.

## Request fields (body)

The request body may be empty or `{}`. No filter parameters are accepted — the endpoint always returns the full set of employees with multiple departments.

## Examples

### curl — personal key

```bash
curl -X POST "https://vibecode.bitrix24.com/v1/humanresources/employees/multidepartment" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### curl — OAuth app

```bash
curl -X POST "https://vibecode.bitrix24.com/v1/humanresources/employees/multidepartment" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### JavaScript — personal key

```javascript
const res = await fetch('https://vibecode.bitrix24.com/v1/humanresources/employees/multidepartment', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})

const { success, data } = await res.json()
console.log(`Employees in several departments: ${data.total}`)
```

### JavaScript — OAuth app

```javascript
const res = await fetch('https://vibecode.bitrix24.com/v1/humanresources/employees/multidepartment', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})

const { success, data } = await res.json()
```

## Response fields

| Field | Type | Description |
|------|-----|---------|
| `success` | boolean | Always `true` on success |
| `data.employees` | array | Array of employees that belong to several departments |
| `data.employees[].userId` | number | Employee identifier |
| `data.employees[].name` | string | Employee name |
| `data.employees[].workPosition` | string \| null | Employee position. `null` if the position is not set. Empty string if set without a value |
| `data.employees[].departments` | array | Departments the employee belongs to. Always two or more elements |
| `data.employees[].departments[].id` | number | Department identifier |
| `data.employees[].departments[].name` | string | Department name |
| `data.total` | number | Number of employees in the output |

## Response example

```json
{
  "success": true,
  "data": {
    "employees": [
      {
        "userId": 1,
        "name": "John Brown",
        "workPosition": "",
        "departments": [
          { "id": 1, "name": "Company" },
          { "id": 9, "name": "Division" },
          { "id": 11, "name": "Work group" },
          { "id": 23, "name": "Sales department" }
        ]
      },
      {
        "userId": 1269,
        "name": "Michael Davis",
        "workPosition": null,
        "departments": [
          { "id": 1, "name": "Company" },
          { "id": 35, "name": "Wholesale sales department" }
        ]
      },
      {
        "userId": 1271,
        "name": "Anna Miller",
        "workPosition": null,
        "departments": [
          { "id": 1, "name": "Company" },
          { "id": 35, "name": "Wholesale sales department" }
        ]
      }
    ],
    "total": 3
  }
}
```

## Error response example

403 — the key lacks the `humanresources` scope:

```json
{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'humanresources' scope"
  }
}
```

## Errors

| HTTP | Code | Description |
|------|-----|---------|
| 403 | `SCOPE_DENIED` | The key lacks the `humanresources` scope |
| 401 | `TOKEN_MISSING` | The API key has no Bitrix24 tokens configured |

Full list of common API errors — [Errors](/docs/errors).

## Known specifics

**Only employees with two or more departments are included in the output.** An employee with a single department is absent from the response. That is why `departments` of each record contains at least two elements, and the `employees` array itself is shorter than the total number of employees from the [number of employees](/docs/humanresources/employees/count).

## See also

- [Number of employees](/docs/humanresources/employees/count)
- [Employees](/docs/humanresources/employees)