Employment object

An object representing an employment period for a particular employee.

In WorkBright, an employee may have multiple Employments – one for each season they are hired to work. Even if your business does not operate seasonally, each employee will have at least one Employment object created when they are first added to the system.

At any given time, a WorkBright accounts operates under a single, active season (also referred to as the "current" season). If an employee has an Employment record for the active season, then they are said to be "employed." When an employee is employed for the active season, they can also be deactivated, e.g. if they resigned or were terminated. Deactivated employees, as well as employees who were not hired for the active season ("unemployed"), do not have access to WorkBright.

Attributes

Type

Description

id

Integer

Identifier for this employment.

employee_id

Integer

Identifier of the employee.

hire_date

  • String_ (format: YYYY-MM-DD)

The employee's hire date.

start_date

  • String_ (format: YYYY-MM-DD)

The employee's start date.

end_date

  • String_ (format: YYYY-MM-DD)

The employee's end date, if applicable.

onboarding_start_date

  • String_ (format: YYYY-MM-DD)

The date an employee should begin onboarding.

employee_document_options

Object

If Remote I-9 is enabled on the account, will return the Boolean values for the staff member i9_remote_countersign_authorized and i9_remote_reverification_authorized, otherwise will return {}.

status

String

The employment status of the employee. Either: active or inactive.

status_note

String

If deactivated, the accompanying note or reason.

status_changed_by

String

Name of individual who last changed employee's status.

status_changed_at

String
(format: ISO 8601)

Timestamp of when employee's employment status was last changed.

season_id

Integer

The ID of the Season this employment is for.

active_season

Boolean

Whether or not the season_id represents the current, active season in the system.

onboarding_email_sent_at

String
(format: ISO 8601 )

Timestamp of when employee's onboarding email was sent.

onboarding_started

Boolean

Whether or not the employee has started the onboarding process.