Contractor Object

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

attribute	type	description
contractorID	string	Zeal Contractor ID
companyID	string	Zeal Company ID
onboarded	boolean	Whether the contractor has been onboarded onto Zeal or not
type	enum	Holds one of the following values: `individual_sole_proprietor` `c_corporation` `s_corporation` `partnership` `trust_estate` `llc` `other`
llc_tax_classification	enum	(Only applicable if `type` is `llc`) Holds one of the following values: `c_corporation` (default) `s_corporation` `partnership`
tin_type	enum	(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_name	string	First name of the contractor
middle_name	string	Middle name of the contractor
last_name	string	Last name of the contractor
email	string	Email of contractor
dob	date	Date of birth of contractor
ssn	string	Social security number of the contractor
ein	string	EIN of the contractor (only accepted if type == "business")
business_name	string	Business Name of the contractor (only accepted if type == "business")
address	string	Residential Street address of the contractor
address_line2	string	Additional address line if needed
city	string	Residential City of contractor
state	string	Residential State of the contractor
zip	string	Residential Zip code of the contractor
employment_status	string	Employment status of the contractor. Default value is "live", other accepted values are "leave" and "terminated".
external_id	string	External ID for a contractor that comes from an employer's HR or other internal systems
paycard_requested	boolean	Set to `true`if the contractor has completed paycard enrollment. The paycard may not be successfully provisioned to the contractor yet. NOTE: Only applicable for Paycards (Early Access)
paycard_enabled	boolean	Set to `true`if the contractor has completed paycard enrollment and the paycard has successfully been provisioned to the contractor NOTE: Only applicable for Paycards (Early Access)
kyc_status	enum	Holds one of the following values: `null` `approved` `denied`
ssn_verification_status	enum	Holds one of the following values: `null` `approved` `declined`

{
 "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",
 "paycard_requested": false,
 "paycard_enabled": false,
 "kyc_status": "approved",
 "ssn_verification_status": "approved"
}