A Worker can have more than one employment through their time at the company. Significant changes in classification or location require a new employment 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).