Get the employee's onboarding status


Retrieves an employee's onboarding status. The data returned helps inform the required onboarding steps and respective completion status.


Admin-facilitated onboarding

admin_onboarding_incompleteAdmin needs to complete the full employee-onboarding.
onboarding_completedEmployee has been fully onboarded and verified.

Employee self-onboarding

admin_onboarding_incompleteAdmin needs to enter basic information about the employee.
self_onboarding_not_invitedAdmin has the intention to invite the employee to self-onboard (e.g., marking a checkbox), but the system has not yet sent the invitation.
self_onboarding_invitedEmployee has been sent an invitation to self-onboard.
self_onboarding_invited_startedEmployee has started the self-onboarding process.
self_onboarding_invited_overdueEmployee's start date has passed, and employee has still not completed self-onboarding.
self_onboarding_awaiting_admin_reviewAdmin needs to review employee's entered information and confirm onboarding.
onboarding_completedEmployee has been fully onboarded and verified.


onboarding_stepsRequirement(s) to be completed
personal_detailsAdd employee's first name, last name, email, date of birth, social security number
compensation_detailsAssociate employee to a job & compensation.
add_work_addressAdd employee work address.
add_home_addressAdd employee home address.
federal_tax_setupSet up federal tax withholdings.
state_tax_setupSet up state tax withholdings.
direct_deposit_setupSet up employee's direct deposit.
employee_form_signingEmployee forms (e.g., W4, direct deposit authorization) are generated & signed.
admin_reviewAdmin reviews & confirms employee details (only required for Employee self-onboarding)
Click Try It! to start a request and see the response here!