Skip to main content
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

​
string
Unique identifier for the object, e.g. wre_cNqYX2J3s9bI2Aa.
​
string
The ID of the worker this employment is associated with.
​
boolean
Whether this is this person’s primary employment or not. One of true or false. A worker can only have one primary employment.
​
boolean
Whether or not this employment is current, i.e. it hasn’t ended and been replaced by another employment, or terminated.
​
string
The status of the employment. Possible values are candidate, pending, active, paused, terminated, cancelled or undefined.
​
string | null
The date the employment starts, or null when no start date has been set.
​
string | null
The date the employment ends, or null while the employment has no scheduled or recorded end.
​
object
A Classification object representing the current classification of this employment.
​
object
A Compensation object representing the current compensation of this employment.
​
object
A Role object representing the current role of this employment.
​
object
A Location object representing the current work location of this employment.
​
object
A Reporting object representing the current reporting relationship of this employment.
​
string
Timestamp of when the employment was created.
​
object | null
A summary of the employment’s onboarding, or null when the employment never had one.