BambooHR API v1
Public
BambooHR's OpenAPI 3.1 description of the BambooHR API (v1) for employee data, time off and reports, published by BambooHR.
Use Cases
API Testing in Postman
Tech / ITDevelopers import the OpenAPI file into Postman to explore and test endpoints.
HR Reporting
Tech / ITAnalysts pull reports from BambooHR in a chosen format for headcount and time-off analysis.
Employee Data Sync
Tech / ITHR and IT teams sync employee records between BambooHR and payroll, identity or directory systems.
Overview
The BambooHR API is a RESTful API for reading and changing employee data in BambooHR. It can also generate reports in several formats. Apps connect with OAuth, using a client ID and secret from the BambooHR developer portal. BambooHR offers the API as a downloadable OpenAPI specification file, written in OpenAPI 3.1. The types in this entry include Employee, TimeOffRequest, TrainingRecord and Report, plus time tracking, goal, file, custom field and webhook types. Use of the developer tools falls under the BambooHR Developer Terms of Service. Developers can use this entry to check employee and time-off shapes before they build HR integrations.
Top entities
Employee, TimeOffRequest, TrainingRecord, Report, Goal, Webhook, CustomField, EmployeeFile, TimeTrackingProject, TimeTrackingTask, ClockEntry, HourEntry
Mappings
- schema.org Person: conceptual. Employee aligns in intent with schema.org Person, not field by field.
For agents
Query the library's CoreModels project for employee and time-off shapes before writing HR integration code. Check field names in a real account, since companies add custom fields. Sample prompt: "Using the BambooHR API v1 schema in the Schematica Library, which fields of a TimeOffRequest give the employee, dates and status?" Read via MCP: get_project_summary with graphProjectId 400c9ad027104f40bcbde03e00eccf35.
Provenance
Publisher: BambooHR. License: not stated by the publisher. Version: 1.0. Format: OpenAPI (listed here as JSON Schema until the library format list includes it). Described by the Schema Librarian on 2026-10-23; auto-cataloged.
Comments: