Return the authenticated user for the current API token.

Return metadata about the current API token (scopes, owner, etc.).

List people (employees). Optional filters: email, locationId, status. Paginated via limit/skip (max 250). Note: Humaans has no manager-side filter on this endpoint — use get_direct_reports for that.

Retrieve a single person by their Humaans id. Employee-scoped custom field values are merged onto the person object as top-level keys named after the field (e.g. "Level": "IC5", "Cost Center": ["R&D"]). Native attributes win on name collisions.

Find one person by exact email match. Returns the person object, or null if not found.

Case-insensitive substring search over firstName/lastName/preferredName across all people. Pulls the full people list then filters client-side.

List direct reports of the given person. Reads the directReports array on the person record.

Walk the management chain upward from the given person. Returns an ordered list starting with the person and ending at the top of the chain (someone with no manager).

Build the subtree of reports under the given person, up to max_depth levels. Uses a single fetch of all people then walks directReports locally.

Count reports for a person. recursive=False gives direct reports only; True gives the full subtree size.

List all companies in the Humaans account.

Retrieve a company by id.

List job roles (historical and current job assignments). Optionally filter by personId.

Retrieve a single job role by id.

List all configured work locations (typically countries/regions for remote teams).

List all physical office spaces.

List compensation records (salary, bonus, etc.). Optional filters: personId, typeId.

Retrieve a single compensation record by id.

List all compensation types configured in the account (salary, bonus, commission, equity, etc.).

Retrieve a single compensation type by id.

List time-away records. Optional filters: personId, startDate, endDate (YYYY-MM-DD).

Retrieve a single time-away record by id.

List all time-away types (vacation, sick, parental, etc.).

List time-away allocations. Optionally filter by personId.

List all time-away policies.

List public holidays. Optional filters: calendarId, year.

List all configured public holiday calendars.

List bank accounts. Optionally filter by personId.

List emergency contacts. Optionally filter by personId.

List equipment assigned to people. Optionally filter by personId.

List documents. Optionally filter by personId.

List all configured custom fields.

List custom field values. Optionally filter by personId.