A Worker can have more than one employment through their time at the company. Significant changes in classification or location require a new employmen to be started for the worker.

For example, when converting a contractor to an employee, their original employment will end, and a new employment will be created to reflect their new status as an employee.

Similarly, when an employee moves from one country to another in a way that necessitates a change in their contract (for example because their local employer will change), a new employment object will be created for them.

In rare cases, a worker may have more than one concurrent employments. This is common in some countries where the company enters into an employment contact with someone, while also engaging with them as a contractor. In this situation, while both employments are current, only one will be marked as primary.

Most of the time, a Worker will only have one Employment record, representing their current primary employment.

Attributes

id
string

Unique identifier for the object, e.g. wre_cNqYX2J3s9bI2Aa.

status
string

Current employment status. One of pending, active, terminated, cancelled, paused or undefined.

type
string

The type of employment relationship. One of employee, contractor or vendor.

primary
boolean

Whether this is this person’s primary employment or not. One of true or false. A worker can only have one primary employment.

current
boolean

Whether or not this employment is current, i.e. it hasn’t ended and been replaced by another employment, or terminated.

starts
date

The date this employment is effective from. This will usually correspond to someone’s start date.

ends
date

The date this employment is effective until. This will usually correspond to someone’s last day.

employer
hash

An object representing the employer that is the counterparty to this employment.

classification
hash

A Classification object representing the current classification of this employment.

compensation
hash

A Compensation object representing the current compensation of this employment.

role
hash

A Role object representing the current role of this employment.

location
hash

A Location object representing the current work location of this employment.

reporting
hash

A Reporting object representing the current reporting relationship of this employment.

consents
hash

An object representing consents obtained from this worker (e.g. consent to receive W-2s electronically).