Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

BambooHR Time Off API

Time-off requests and balances

BambooHR Time Off API is one of 8 APIs that BambooHR publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Time Off. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 2 paths. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://api.bamboohr.com/api/gateway.php/{companyDomain}/v1.

2 operations 2 paths 0 schemas 1 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://api.bamboohr.com/api/gateway.php
Authentication
HTTP Basic, OAuth 2.0
Resource Areas
1

Authentication & Security 2

BambooHR Time Off API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 1 scope.

  • basicAuth — HTTP Basic auth. Use the API key as the username and any non-empty string as the password.
  • oauth2 — OAuth 2.0 authorization code flow (for multi-customer apps).

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Time Off 2

Time-off requests and balances

GET
/time_off/requests
List time off requests
listTimeOffRequests 7 params → 200
PUT
/employees/{id}/time_off/request
Add a time off request for an employee
addTimeOffRequest 1 param body → 201

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bamboohr-time-off-api-openapi.yml Raw ↑

Other APIs BambooHR publishes across the network.

BambooHR REST API
BambooHR Webhooks
BambooHR Directory API
BambooHR Employees API
BambooHR Files API
BambooHR Meta API
BambooHR Reports API