Unified Models
- Bank Info
- Benefits
- Employer Benefits
- Dependents
- Dependent Benefits
- Company
- Employee
- Group
- Employments
- Pay Groups
- Payroll Runs
- Payroll Run Calendar
- Employee Payroll Runs
- Time Off
- Time Off Balance
- Time Sheet Entry
- Compensation
Get Employees
Returns a list of Employee objects.
curl --request GET \
--url https://api.bindbee.dev/api/hris/v1/employees \
--header 'Authorization: Bearer <token>' \
--header 'x-connector-token: <x-connector-token>'
{
"cursor": "MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1",
"page_size": 50,
"items": [
{
"id": "018b18ef-c487-703c-afd9-0ca478ccd9d6",
"remote_id": "123321",
"modified_at": "2021-10-16T00:00:00Z",
"raw_data": {
"key_1": "Platform dependent data 1",
"key_2": "Platform dependent data 2"
},
"custom_fields": {
"category_group": "REG",
"disability_type": "ASBERG",
"hire_date": "1991-03-16T00:00:00",
"hire_source": "REFER",
"nationality": "USA",
"original_hire_date": "1991-03-16T00:00:00"
},
"employee_number": "1",
"company": "<any>",
"first_name": "Kunal",
"middle_name": "Christopher",
"last_name": "Tyagi",
"preferred_name": "Dark Knight",
"display_full_name": "Kunal Tyagi",
"username": "kunaltyagi",
"designation": "Chief Technology Officer",
"groups": [
"<any>"
],
"department": "Engineering",
"division": "Bangalore Division",
"work_email": "kunal@bindbee.dev",
"personal_email": "kunaltyagi77@gmail.com",
"mobile_phone_number": "+1234567890",
"home_phone_number": "+1234567890",
"country_code": "+91",
"home_location": {
"city": "London",
"country": "UK",
"location": "UK-HO-London",
"name": "UK-HO-London",
"postal_code": "56273",
"state": "LND",
"street_1": "1011",
"street_2": "Lane number 4, Golden Villa"
},
"work_location": {
"city": "London",
"country": "UK",
"location": "UK-HO-London",
"name": "UK-HO-London",
"postal_code": "56273",
"state": "LND",
"street_1": "1011",
"street_2": "Lane number 4, Golden Villa"
},
"manager": "<any>",
"pay_group": "<any>",
"ssn": "1234567890",
"gender": "MALE",
"ethnicity": "ASIAN_OR_INDIAN_SUBCONTINENT",
"marital_status": "SINGLE",
"date_of_birth": "1986-10-27T00:00:00Z",
"start_date": "2023-03-05T00:00:00Z",
"remote_created_at": "2023-03-01T00:00:00Z",
"employment_status": "INACTIVE",
"termination_date": "2023-06-05T00:00:00Z",
"avatar": "http://alturl.com/h2h8m",
"payroll_run_calendar": "<any>"
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
Query Parameters
If provided, will only return employees for this manager.
The third-party API ID of the matching object.
If provided, will only return employees for this company
Whether to include the original data Bindbee fetched from the third-party to produce these models.
Whether to include custom fields in the response.
If provided, will only return employees with this employment status.
ACTIVE
, PENDING
, INACTIVE
, ACTIVE_EXTERNAL
, INACTIVE_EXTERNAL
If provided, will only return employees for this employee number
Number of results to return per page. Maximum size is 100.
1 <= x <= 1000
The pagination cursor value.
If provided, only objects synced by Bindbee after this date time will be returned. Format: DateTime (ISO 8601)
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces. You can also specify required fields in [] for each relation name.
Response
Cursor value to fetch next set of items
"MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1"
Indicates the count of items in the response
50
"018b18ef-c487-703c-afd9-0ca478ccd9d6"
The third-party API ID of the matching object.
"123321"
This is the datetime that this object was last updated by Bindbee
"2021-10-16T00:00:00Z"
The custom fields related to the model
{
"category_group": "REG",
"disability_type": "ASBERG",
"hire_date": "1991-03-16T00:00:00",
"hire_source": "REFER",
"nationality": "USA",
"original_hire_date": "1991-03-16T00:00:00"
}
This is the Raw data
{
"key_1": "Platform dependent data 1",
"key_2": "Platform dependent data 2"
}
The employee's number that appears in the third-party integration's UI.
"1"
The ID of the employee's company.
The employee's first name.
"Kunal"
The employee's middle name.
"Christopher"
The employee's last name.
"Tyagi"
The employee's preferred first name.
"Dark Knight"
The employee's full name, to use for display purposes. If a preferred first name is available, the full name will include the preferred first name.
"Kunal Tyagi"
The employee's username that appears in the remote UI.
"kunaltyagi"
The employee's current designation/title
"Chief Technology Officer"
The IDs of the groups that the employee belongs to.
The employee's department
"Engineering"
The employee's division
"Bangalore Division"
The employee's work email.
"kunal@bindbee.dev"
The employee's personal email.
"kunaltyagi77@gmail.com"
The employee's mobile phone number.
"+1234567890"
The employee's home phone number.
"+1234567890"
The employee's country code
"+91"
The employee's home address.
Name of the location
"UK-HO-London"
Location
"UK-HO-London"
Street 1
"1011"
Street 2
"Lane number 4, Golden Villa"
City
"London"
State
"LND"
Postal Code
"56273"
Country
"UK"
{
"city": "London",
"country": "UK",
"location": "UK-HO-London",
"name": "UK-HO-London",
"postal_code": "56273",
"state": "LND",
"street_1": "1011",
"street_2": "Lane number 4, Golden Villa"
}
The employee's work address.
Name of the location
"UK-HO-London"
Location
"UK-HO-London"
Street 1
"1011"
Street 2
"Lane number 4, Golden Villa"
City
"London"
State
"LND"
Postal Code
"56273"
Country
"UK"
{
"city": "London",
"country": "UK",
"location": "UK-HO-London",
"name": "UK-HO-London",
"postal_code": "56273",
"state": "LND",
"street_1": "1011",
"street_2": "Lane number 4, Golden Villa"
}
The employee ID of the employee's manager.
The employee's pay group
The employee's social security number.
"1234567890"
The employee's gender.
"MALE"
The employee's ethnicity.
"ASIAN_OR_INDIAN_SUBCONTINENT"
The employee's filing status as related to marital status
"SINGLE"
The employee's date of birth.
"1986-10-27T00:00:00Z"
The date that the employee started working. If an employee was rehired, the most recent start date will be returned.
"2023-03-05T00:00:00Z"
When the third party's employee was created.
"2023-03-01T00:00:00Z"
The employment status of the employee. Possible values include: ACTIVE, PENDING, INACTIVE, or - in cases where there is no clear mapping - the original value passed through.
"INACTIVE"
The employee's termination date.
"2023-06-05T00:00:00Z"
The URL of the employee's avatar image.
"http://alturl.com/h2h8m"
The employee's payroll calendar
curl --request GET \
--url https://api.bindbee.dev/api/hris/v1/employees \
--header 'Authorization: Bearer <token>' \
--header 'x-connector-token: <x-connector-token>'
{
"cursor": "MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1",
"page_size": 50,
"items": [
{
"id": "018b18ef-c487-703c-afd9-0ca478ccd9d6",
"remote_id": "123321",
"modified_at": "2021-10-16T00:00:00Z",
"raw_data": {
"key_1": "Platform dependent data 1",
"key_2": "Platform dependent data 2"
},
"custom_fields": {
"category_group": "REG",
"disability_type": "ASBERG",
"hire_date": "1991-03-16T00:00:00",
"hire_source": "REFER",
"nationality": "USA",
"original_hire_date": "1991-03-16T00:00:00"
},
"employee_number": "1",
"company": "<any>",
"first_name": "Kunal",
"middle_name": "Christopher",
"last_name": "Tyagi",
"preferred_name": "Dark Knight",
"display_full_name": "Kunal Tyagi",
"username": "kunaltyagi",
"designation": "Chief Technology Officer",
"groups": [
"<any>"
],
"department": "Engineering",
"division": "Bangalore Division",
"work_email": "kunal@bindbee.dev",
"personal_email": "kunaltyagi77@gmail.com",
"mobile_phone_number": "+1234567890",
"home_phone_number": "+1234567890",
"country_code": "+91",
"home_location": {
"city": "London",
"country": "UK",
"location": "UK-HO-London",
"name": "UK-HO-London",
"postal_code": "56273",
"state": "LND",
"street_1": "1011",
"street_2": "Lane number 4, Golden Villa"
},
"work_location": {
"city": "London",
"country": "UK",
"location": "UK-HO-London",
"name": "UK-HO-London",
"postal_code": "56273",
"state": "LND",
"street_1": "1011",
"street_2": "Lane number 4, Golden Villa"
},
"manager": "<any>",
"pay_group": "<any>",
"ssn": "1234567890",
"gender": "MALE",
"ethnicity": "ASIAN_OR_INDIAN_SUBCONTINENT",
"marital_status": "SINGLE",
"date_of_birth": "1986-10-27T00:00:00Z",
"start_date": "2023-03-05T00:00:00Z",
"remote_created_at": "2023-03-01T00:00:00Z",
"employment_status": "INACTIVE",
"termination_date": "2023-06-05T00:00:00Z",
"avatar": "http://alturl.com/h2h8m",
"payroll_run_calendar": "<any>"
}
]
}