Skip to main content

​
The employment object

​
id
string<uuid>

Unique ID of the employment.

Can be used to filter the following data sets:

​
account
string<uuid>

ID of the account associated with the employment.

​
user
string<uuid>

ID of the user associated with the employment.

​
created_at
string<datetime>

Timestamp (ISO 8601) when the employment object was created.

​
employer
string

Employer name on the most recent paystub associated with the employment.

​
employment_status
enum<string>

Job status of the employment.

inactive and terminated definitions vary by Item and can overlap. inactive typically indicates the employee left voluntarily, is on leave, or has not been active for a certain period of time. terminated typically indicates the employee is no longer employed. Specific reasons for termination, if available, are returned in the termination_reason field.

We recommend using data from the /paystubs and /gigs endpoints to construct a more wholistic timeline of employment history.

Available options:
active,
inactive,
terminated
​
origin
enum<string>

Whether the employment was defined by the connected payroll system or paystubs.

  • retrieved - Employment defined by the connected payroll system.
  • acquired - Employment defined by retrieved paystubs.
Available options:
retrieved,
acquired