---
id: kombo
version: "1.3.7"
license: unclear
license_treatment: unclear
maintenance: active
---

# kombo — The official Python SDK for the Kombo Unified API

License: unclear · Maintenance: active · Downloads: 111.7K/mo

## What it is and what it does

Kombo is an official Python SDK that abstracts access to the Kombo Unified API, a platform for connecting to multiple HR and recruitment systems (HRIS, ATS, assessment, payroll) through a single interface. It uses httpx and httpcore for HTTP communication, pydantic for type validation, and jsonpath-python for response parsing, providing type-safe method calls and automatic request/response handling.

The SDK is designed for developers integrating with customer HR systems without building direct connectors to each platform. It handles authentication via API key, supports region selection (EU or US), includes built-in retry logic, and exposes resources like Assessment, ATS, and HRIS with methods for reading and writing employee, candidate, and job data. The package is currently in beta but declares the core API stable, with a 3-month grace period after Python EOL before dropping support.

Use it for:

- Fetch employee records from a customer's HRIS system via a single integration ID without learning multiple vendor APIs.
- Build a recruitment workflow tool that reads applications and candidates from ATS systems and moves them between pipeline stages.
- Sync assessment packages and order results across multiple customer assessment platforms through a unified interface.
- Automate payroll data retrieval and updates across different payroll systems for multi-tenant HR software.
- Create a data migration or reporting tool that pulls employee and candidate data from multiple HR vendors in parallel.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Type-safe Python SDK for the Kombo Unified API, providing structured access to HRIS, ATS, assessment, and payroll integrations across multiple HR systems.

Yes, if you need to integrate with multiple HR systems and have a valid Kombo API key. The SDK is actively maintained, has low install friction, and offers type safety via pydantic. However, verify the unclear license status before committing to production, and note that it is still in beta—review the changelog for any breaking changes in minor updates.

## Install

pip install kombo
uv add kombo
poetry add kombo

## Installing kombo

Before you install: Low install friction with a pure Python wheel. Actively maintained with a release 1 day old as of the fact sheet date. Requires Python 3.10 or later.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in production or proprietary projects.

Quickstart:

pip install kombo

from kombo import SDK

with SDK(api_key="<YOUR_BEARER_TOKEN_HERE>") as sdk:
    res = sdk.general.check_api_key()
    print(res)

Requires Python 3.10 or later; requires a valid Kombo API key to authenticate.

Verify before relying:

- Whether the package is suitable for production use despite being marked 'currently in beta'.
- Exact scope and stability guarantees of the 'core API structure, methods, and input/output objects' mentioned as stable.
- Whether region selection (EU vs US) requires code changes or environment configuration.
- Pagination and error-handling behavior details not covered in the excerpt.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 111.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kombo unified api sdk, hr systems integration python, hris ats payroll api client, multi-system hr connector, employee data api sdk, recruitment integration python, hr platform abstraction layer, hr-integration, unified-api, type-safe-sdk

[View on SkillFed](https://skillfed.io/packages/kombo) · [View on PyPI](https://pypi.org/project/kombo/)