---
updatedAt: 2026-06-17T01:02:09.000Z
agentTools:
  projectIndex: https://documentation.bamboohr.com/llms.txt
---

# Official SDKs

Official BambooHR SDKs to accelerate your API integration.

BambooHR provides official SDKs to help you integrate with our API quickly and reliably. Our SDKs handle authentication, error handling, retries, and provide fully typed models for a great developer experience.

All official SDKs are open source under the MIT license.

## Official SDKs

### PHP

The PHP SDK provides a modern, fluent interface for the BambooHR API with full OAuth 2.0 support.

**Requirements:** PHP 8.1+

**Install via Composer:**

```bash
composer require bamboohr/api
```

**Quick start**:

```php
$client = (new ApiClient())
    ->withApiKey('your-api-key')
    ->forCompany('your-company')
    ->build();

$employee = $client->employees()->getEmployee('firstName,lastName', '123');
```

**Resources:**

* <Anchor label="GitHub Repository" target="_blank" href="https://github.com/BambooHR/bhr-api-php">GitHub Repository</Anchor>
* <Anchor label="Getting Started Guide" target="_blank" href="https://github.com/BambooHR/bhr-api-php/blob/master/GETTING_STARTED.md">Getting Started Guide</Anchor>
* <Anchor label="Authentication Guide" target="_blank" href="https://github.com/BambooHR/bhr-api-php/blob/master/AUTHENTICATION.md">Authentication Guide</Anchor>
* <Anchor label="Migration Guide (v1 to v2)" target="_blank" href="https://github.com/BambooHR/bhr-api-php/blob/master/MIGRATION.md">Migration Guide (v1 to v2)</Anchor>

## Legacy SDKs

The following SDKs are no longer actively maintained. They may still work for basic use cases, but we recommend building directly against the REST API for now.

We may update these SDKs in the future based on demand.

| SDK  | Status       | Repository                                                                                             |
| :--- | :----------- | :----------------------------------------------------------------------------------------------------- |
| .NET | Unmaintained | <Anchor label="GitHub" target="_blank" href="https://github.com/BambooHR/bhr-api-vb">GitHub</Anchor>   |
| Java | Unmaintained | <Anchor label="GitHub" target="_blank" href="https://github.com/BambooHR/bhr-api-java">GitHub</Anchor> |

## Community SDKs

These SDKs are created and maintained by the community. BambooHR does not provide official support for them.

| SDK    | Repository                                                          | Maintainer    |
| :----- | :------------------------------------------------------------------ | :------------ |
| Python | [PyBambooHR](https://pypi.org/project/PyBambooHR/)                  | Scott Blevins |
| Ruby   | [Bamboozled](https://github.com/Skookum/bamboozled)                 | Mark Rickert  |
| Perl   | [WebService-BambooHR](https://github.com/neilb/WebService-BambooHR) | Neil Bowers   |

## Building Your Own Integration

Don't see your language? The BambooHR API is a standard REST API that works with any HTTP client. Check out our [API Documentation](https://documentation.bamboohr.com/) for complete endpoint references.

<Callout icon="📘" theme="info">
  **What SDK would help you most?**

  We're planning future SDK development and want to hear from you. If you'd like official support for a specific language, or improvements to an existing one, <Anchor label="contact us" target="_blank" href="https://www.bamboohr.com/contact/">contact us</Anchor> with your use case.
</Callout>