Get Employee Payroll Runs

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-connector-token

string

required

Query Parameters

employee_id

string | null

The ID of the employees to fetch employee payroll run for The ID of the employees to fetch employee payroll run for

payroll_run_id

string | null

The IDs of the payroll runs to fetch employee payroll run for The IDs of the payroll runs to fetch employee payroll run for

remote_id

string

The third-party API ID of the matching object. The third-party API ID of the matching object.

include_raw_data

boolean

default:false

Whether to include the original data Bindbee fetched from the third-party to produce these models. Whether to include the original data Bindbee fetched from the third-party to produce these models.

include_custom_fields

boolean

default:false

Whether to include custom fields in the response. Whether to include custom fields in the response.

page_size

integer

default:50

Number of results to return per page. Maximum size is 100. Number of results to return per page. Maximum size is 100.

Required range: 1 <= x <= 100

cursor

string

The pagination cursor value. The pagination cursor value.

modified_after

string

If provided, only objects synced by Bindbee after this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects synced by Bindbee after this date time will be returned. Format: DateTime (ISO 8601)

start_date_from

string

If provided, only objects with start_date same or after this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects with start_date same or after this date time will be returned. Format: DateTime (ISO 8601)

start_date_to

string

If provided, only objects with start_date same or before this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects with start_date same or before this date time will be returned. Format: DateTime (ISO 8601)

end_date_from

string

If provided, only objects with end_date same or after this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects with end_date same or after this date time will be returned. Format: DateTime (ISO 8601)

end_date_to

string

If provided, only objects with end_date same or before this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects with end_date same or before this date time will be returned. Format: DateTime (ISO 8601)

check_date_from

string

If provided, only objects with check_date same or after this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects with check_date same or after this date time will be returned. Format: DateTime (ISO 8601)

check_date_to

string

If provided, only objects with check_date same or before this date time will be returned. Format: DateTime (ISO 8601) If provided, only objects with check_date same or before this date time will be returned. Format: DateTime (ISO 8601)

expand

string

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. 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

Successful Response

cursor

string | null

required

Cursor value to fetch next set of items

Example:

"MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1"

page_size

integer

required

Indicates the count of items in the response

Example:

50

items

HrisEmployeePayrollRun · object[]

required

Show child attributes

items.id

string<uuid>

required

Example:

"018b18ef-c487-703c-afd9-0ca478ccd9d6"

items.remote_id

string | null

required

The third-party API ID of the matching object.

Example:

"123321"

items.modified_at

string

required

This is the datetime that this object was last updated by Bindbee

Example:

"2021-10-16T00:00:00Z"

items.custom_fields

Custom Fields · object

required

The custom fields related to the model

Example:

{
  "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"
}

items.employee

any | null

required

The employee whose payroll is being run.

Example:

"018b168d-70f9-7043-a796-56d66a4f8f07"

items.payroll_run

any | null

required

The payroll being run.

Example:

"018b709e-b6ef-7db4-902a-a064157bdba2"

items.gross_pay

required

The total earnings throughout a given period for an employee before any deductions are made.

Example:

772277.77

items.net_pay

required

The take-home pay throughout a given period for an employee after deductions are made.

Example:

577221.27

items.start_date

string | null

required

The day and time the benefit started.

Example:

"2023-07-01T00:00:00Z"

items.end_date

string | null

required

The day and time the benefit ended.

Example:

"2023-07-31T00:00:00Z"

items.check_date

string | null

required

The day and time the payroll run was checked.

Example:

"2023-08-31T00:00:00Z"

items.earnings

Earning · object[] | null

required

The earnings of the Employee

Show child attributes

items.earnings.amount

required

The amount earned.

Example:

"27151"

items.earnings.name

string | null

required

The type of earning. Possible values include: SALARY, REIMBURSEMENT, OVERTIME, BONUS, or - in cases where there is no clear mapping - the original value passed through.

Example:

"SALARY"

Example:

[{ "amount": "27151", "name": "SALARY" }]

items.deductions

Deduction · object[] | null

required

The deductions of the Employee

Show child attributes

items.deductions.name

string | null

required

The deduction's name.

Example:

"Social Security"

items.deductions.employee_deduction

required

The amount of money that is withheld from an employee's gross pay by the employee.

Example:

27.22

items.deductions.company_deduction

required

The amount of money that is withheld on behalf of an employee by the company.

Example:

77.57

Example:

[
  {
    "company_deduction": "77.57",
    "employee_deduction": "27.22",
    "name": "Social Security"
  }
]

items.taxes

Tax · object[] | null

required

The taxes of the Employee

Show child attributes

items.taxes.name

string | null

required

The tax's name.

Example:

"California State Income Tax"

items.taxes.amount

required

The tax amount.

Example:

175.22

Example:

[
  {
    "amount": "175.22",
    "name": "California State Income Tax"
  }
]

items.raw_data

Raw Data · object

This is the Raw data

Example:

{
  "key_1": "Platform dependent data 1",
  "key_2": "Platform dependent data 2"
}

Unified Models

Authorizations

Headers

Query Parameters

Response