# Workday — HRIS API: gotchas

> Canonical URL: https://developers.apideck.com/apis/hris/workday/gotchas

## GET /hris/employees

To avoid request timeouts when fetching all employees, it's recommended to use a limit of 20. Workday can return large amounts of data per employee, and requests exceeding 30 seconds will timeout with an "Endpoint request timed out" error.

List Employees returns the employee's department (`department_id`, `department_name`), with the same values as Get Employee. `company_id`, `company_name`, `division_id`, `division` and `custom_fields` are returned on Get Employee only.

## GET /hris/employees/{id}

Job Level (e.g., Junior, Intermediate, Senior, Principal) is exposed as a custom field `Job_Level_ID` on the Get Employee response only — not on List Employees. It is sourced from a separate `Get_Job_Profiles` SOAP call against Workday's Staffing service and merged into the response.

Job Level is omitted when the worker's job profile does not define `Job_Level_Reference` in Workday (configured per profile), or when the connection's Integration System User does not have access to the Staffing web service. Other custom fields and the rest of the response are unaffected in either case.

This enrichment is intentionally not performed on List Employees to avoid an extra SOAP call per worker.

On Get Employee, `manager.name`, `manager.first_name`, `manager.last_name`, `manager.email` and `manager.employment_status` are populated from a separate lookup of the manager's own worker record (List Employees returns `manager.id` only). When Workday cannot return that record — for example the manager is terminated, or is outside the integration user's security scope — those fields are omitted, `manager.id` is still returned, the rest of the employee is unaffected, and the response carries a `meta.warnings` entry of type `downstream_request_failed`. When the employee has no manager reference, `manager` is omitted from the response entirely and no warning is emitted.


[API reference](https://developers.apideck.com/apis/hris/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/hris/coverage)