Get a list of employees in the company directory with basic information. Returns employee ID, display name, first name, last name, job title, work phone, and other directory fields. Note: The directory can be disabled in company settings, so the custom reports API may be more reliable for bulk employee retrieval.

Retrieve detailed information about a specific employee by their ID. You can specify which fields to return using the 'fields' parameter. Returns current values for standard fields and the latest values for historical fields like job title or compensation. Use the Get Employee Fields tool to discover available field names.

Discover all available employee fields and their metadata in your BambooHR account. Returns field ID, name, type, and other properties. Use this to understand what fields you can query or update when working with employee data. Essential for building dynamic queries.

Add a new employee to BambooHR. At minimum, you must provide firstName and lastName. You can optionally include other fields like email, phone, hireDate, department, jobTitle, etc. For employees on Trax Payroll, additional required fields include: employeeNumber, dateOfBirth, ssn, gender, maritalStatus, address, city, state, country, employmentHistoryStatus, exempt, payType, payRate, payPer, location, department, and division.

Update an existing employee's information. Only include the fields you want to change; all other fields will remain unchanged. You can update any standard or custom employee field. Use the Get Employee Fields tool to discover available field names.

Get a list of employees who have had data changes since a specified date. Useful for syncing employee data with external systems or tracking recent updates. Returns employee IDs and the timestamp of their last change.

Generate a custom report with specified employee fields and filters. This is the most flexible and reliable way to retrieve bulk employee data. You can specify which fields to include, filter by various criteria, and choose the output format (JSON, CSV, PDF, XLS, XML). Returns employee data based on your specifications.

Retrieve time off requests with optional filtering by date range, status, employee ID, or time off type. Returns details including employee, dates, status (approved/denied/requested/canceled), amount, and notes. Useful for generating time off reports, tracking approvals, or monitoring team availability.

View all time off policies assigned to a specific employee, including current balances, accrual rates, and policy details. Shows available vacation days, sick days, and other time off types. Essential for checking if an employee has sufficient balance before approving time off requests.

Submit a time off request for an employee. Specify the employee, time off type, start and end dates, amount, and optional notes. The request will go through the company's approval workflow. Can be used to request vacation, sick days, or other time off types configured in the system.