Employment Status

There are three fields used with these endpoints: Employees with similar aliases in the API:

1. status
2. employmentStatus
3. employmentHistoryStatus

There is also a table (used with these endpoints: Employee Tables with the alias "employmentHistoryStatus" that is NOT deprecated and will NOT be removed.

"status" is the "active", "inactive" status of the employee.

"employmentStatus" is an older name for the same field, and was deprecated due to its confusing name.

"employmentHistoryStatus" is the actual employment status of an employee, like "contractor", "full-time", "part-time", etc. and is a list of values that can be customized for your use. It is also associated with ACA status.

"employmentStatus", with its confusing name, has been deprecated for 3 years, and we will be removing it beginning April 1st, 2017. From what we can see, usage is very rare, so it's likely you will not be affected. If you are using "employmentStatus", you can switch to "status" to get the exact same behavior.