Skip to main content
GET
Get Employee Custom Paperwork
Returns the custom paperwork forms this employee must complete, and whether each one is complete. These are the same custom forms the employee is shown during onboarding. A form is included only when it is live, its effective date has passed, it is not archived, and it matches the employee’s worker type, jurisdiction, and attribute rules. Jurisdictions are the US, the employee’s residence state, and the state of their work location. all_required_complete is true when every returned form is complete, including when paperwork is empty. Archived forms are not listed, even if the employee signed them. Pass companyID and employeeID as query parameters. The API key must be allowed to access that company. Custom paperwork must be enabled for the company. If it is not, the request returns Your company does not have access to interact with this route. (code 126, status 403). The employee must have a work location that Zeal can load. If it is missing, the request returns a Work Location(s) not found error.

Authorizations

Authorization
string
header
required

Query Parameters

companyID
string
required

Company ID of the employer

employeeID
string
required

Employee ID

Response

200

success
boolean
testMode
boolean
data
object