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
typeenumHolds one of the following values:
individual_sole_proprietor
c_corporation
s_corporation
partnership
trust_estate
llc
other
llc_tax_classificationenum(Only applicable if type is llc)
Holds one of the following values:
c_corporation (default)
s_corporation
partnership
tin_typeenum(Only applicable if type is individual_sole_proprietor)
Holds one of the following values:
ssn
ein(If ein is passed, then the ein field will be required)
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
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
paycard_enabledbooleanSet to trueif the contractor has completed paycard enrollment
NOTE: Only applicable for Paycards (Early Access)
{
 "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"
}