Contractor Object

The Contractor Object represents a 1099 contractor for a given company.

attributetypedescription
contractorIDstringZeal Contractor ID
companyIDstringZeal Company ID
onboardedbooleanWhether the contractor has been onboarded onto Zeal or not
typestringHolds one of the following values:
individual
business
first_namestringFirst name of the contractor
middle_namestringMiddle name of the contractor
last_namestringLast name of the contractor
emailstringEmail of contractor
dobdateDate of birth of contractor
ssnstringSocial security number of the contractor (only accepted if type == "individual")
einstringEIN of the contractor (only accepted if type == "business")
business_namestringBusiness Name of the contractor (only accepted if type == "business")
addressstringResidential Street address of the contractor
address_line2stringAdditional address line if needed
citystringResidential City of contractor
statestringResidential State of the contractor
zipstringResidential Zip code of the contractor
employment_statusstringEmployment status of the contractor. Default value is "live", other accepted values are "leave" and "terminated".
external_idstringExternal ID for a contractor that comes from an employer's HR or other internal systems
{
 "contractorID": "1234567890",
 "companyID": "0987654321",
 "onboarded": true,
 "type": "business",
 "first_name": "erlich",
 "middle_name": "null",
 "last_name": "bachman",
 "email": "[email protected]",
 "dob": "1998-05-05",
 "ein": 12-3456789,
 "business_name": "null",
 "address": "320 Pancake Hollow Road",
 "address_line2": "null",
 "city": "Highland",
 "state": "NY",
 "zip": "12528",
 "employment_status": "live",
 "external_id": 123
}