---
title: "/employees/orgchart"
method: GET
path: "/employees/orgchart"
---

# /employees/orgchart

`GET /employees/orgchart`

Returns org chart nodes for the account. Required scope: `r_employees`. Supports account tokens.

Each node contains an employee `content` payload, its `parent_id` (the manager's SPI key), and `direct_reports_count` (loaded only at the currently requested level).

When no filters and no `employee_id` are provided, the response contains top-level employees (those without a manager) together with their first-level direct reports. Provide `employee_id` to return the direct reports of a specific employee, optionally with `include_manager=true` to also receive the employee itself and its manager. Providing `legal_entity_ids` or `department_ids` returns every employee that matches the filters across the entire chart (no pagination level is applied).

## Query parameters

- `legal_entity_ids` string[]
- `department_ids` string[]
- `employee_id` string
- `include_manager` boolean

## Response `200`

200

- object[]
  - `id` string — SPI key of the employee
  - `name` string — Full name of the employee
  - `avatar_url` string, nullable — URL of the employee's avatar image
  - `parent_id` string, nullable — SPI key of the employee's manager (the node's parent in the org chart), or `null` at the top of the tree
  - `direct_reports_count` integer, nullable — Number of direct reports for this employee. Present only for nodes whose children are loaded at the requested level.
  - `content` object
    - `id` string
    - `name` string
    - `avatar` string, nullable — URL of the employee's avatar (falls back to the CSV-import avatar when no primary avatar is set)
    - `initials` string
    - `title` string — Job title of the employee
    - `state` string — Employee state. One of: `draft`, `published`, `inactive`.
    - `department` string, nullable — Name of the department the employee belongs to
    - `entity` string, nullable — Name of the legal entity the employee is assigned to
    - `email` string, nullable — Work email of the employee
    - `employee_number` string, nullable — Employee number as used for payroll or HR tracking
    - `hire_date` string, nullable — Employee start date (ISO 8601)
    - `division` string, nullable — Label of the division the employee is part of
    - `manager` string, nullable — Full name of the employee's manager
    - `filler_node` boolean — Only returned when `legal_entity_ids` or `department_ids` filters are applied. `true` when the node is included only to preserve the hierarchy path to a matching descendant and does not itself match the filters.

## Other responses

- `403` — 403

---

[API](https://skmtc.net/workable/apis/account-root.md) · [All operations](https://skmtc.net/workable/apis/account-root/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workable/account-root/versions/3ead9ec42165/schema)