Bindbee Employees API
Normalized employee records from connected HRIS systems, including employment, compensation, benefits, groups and reporting hierarchy.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bindbee-employees-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Bindbee Employees API
description: The Bindbee API provides a unified HRIS and ATS integration layer that allows companies to connect with 50+ HR systems including BambooHR, Workday, ADP, Greenhouse, Lever, and others through a single normalized API. Access employee data, job listings, candidates, payroll, time-off, and departments without managing individual integrations.
version: v1
contact:
name: Bindbee Support
url: https://docs.bindbee.dev/
license:
name: Proprietary
url: https://bindbee.dev/
x-generated-from: documentation
servers:
- url: https://api.bindbee.dev/v1
description: Bindbee Unified API
tags:
- name: Employees
description: Employee records from connected HRIS systems
paths:
/hris/employees:
get:
operationId: listEmployees
summary: Bindbee List Employees
description: Returns a paginated list of employees from the connected HRIS system. Normalized across providers like BambooHR, Workday, and ADP.
tags:
- Employees
security:
- apiKeyAuth: []
parameters:
- name: x-connector-token
in: header
required: true
description: The connector token for the specific HR system integration.
schema:
type: string
- name: page_size
in: query
required: false
schema:
type: integer
default: 25
description: Number of results per page.
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response.
responses:
'200':
description: List of employees.
content:
application/json:
schema:
$ref: '#/components/schemas/EmployeesResponse'
examples:
ListEmployees200Example:
summary: Default listEmployees 200 response
x-microcks-default: true
value:
data:
- id: emp-abc123
first_name: Jane
last_name: Smith
email: jsmith@example.com
job_title: Software Engineer
department: Engineering
employment_status: active
start_date: '2022-03-15'
next_cursor: cursor-xyz
has_more: true
'401':
description: Unauthorized.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/hris/employees/{id}:
get:
operationId: getEmployee
summary: Bindbee Get Employee
description: Returns a single employee record by ID.
tags:
- Employees
security:
- apiKeyAuth: []
parameters:
- name: x-connector-token
in: header
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
example: emp-abc123
responses:
'200':
description: Employee record.
content:
application/json:
schema:
$ref: '#/components/schemas/Employee'
examples:
GetEmployee200Example:
summary: Default getEmployee 200 response
x-microcks-default: true
value:
id: emp-abc123
first_name: Jane
last_name: Smith
email: jsmith@example.com
job_title: Software Engineer
department: Engineering
employment_status: active
start_date: '2022-03-15'
'404':
description: Employee not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
ErrorResponse:
title: Error Response
description: Standard error response.
type: object
properties:
error:
type: string
description: Error message.
example: resource not found
code:
type: integer
description: HTTP status code.
example: 404
Employee:
title: Employee
description: A normalized employee record from a connected HRIS system.
type: object
properties:
id:
type: string
description: Bindbee employee ID.
example: emp-abc123
first_name:
type: string
description: Employee first name.
example: Jane
last_name:
type: string
description: Employee last name.
example: Smith
email:
type: string
description: Employee work email.
example: jsmith@example.com
job_title:
type: string
description: Job title.
example: Software Engineer
department:
type: string
description: Department name.
example: Engineering
employment_status:
type: string
description: Employment status.
enum:
- active
- inactive
- terminated
example: active
start_date:
type: string
format: date
description: Employment start date.
example: '2022-03-15'
EmployeesResponse:
title: Employees Response
description: Paginated list of employee records.
type: object
properties:
data:
type: array
description: Array of employee records.
items:
$ref: '#/components/schemas/Employee'
next_cursor:
type: string
description: Cursor for next page.
example: cursor-xyz
has_more:
type: boolean
description: Whether more records exist.
example: true
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Bearer API key in Authorization header. Also pass x-connector-token for the specific integration.