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	Holds one of the following values: `c_corporation` (default) `s_corporation` `partnership` (Only applicable if `type` is `llc`)
tin_type	enum	Holds one of the following values: `ssn` `ein` (If `ein` is passed, then the `ein` field will be required) (Only applicable if `type` is `individual_sole_proprietor`)
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
phone_number	string	Phone number of contractor
ssn	string	Social security number of the contractor
ein	string	EIN of the contractor (Applicable for all `type` options, except if `type` is `individual_sole_proprietor` and `tin_type` is `ein`)
business_name	string	Business Name of the contractor (Applicable for all `type` options, except for `individual_sole_proprietor` )
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
instant_pay_enabled	boolean	Set to `true` if the contractor has completed instant pay enrollment. NOTE: Only applicable for Instant Pay (Early Access)

JSON

{
  "contractorID": "c9f1e2a47d3b4f8a9c2e1a6b8d4f3e21",
  "companyID": "a7e3c91f4b2d8f5e9c6a1d0b4e8f2c73",
  "onboarded": true,
  "type": "c_corporation",
  "tin_type": null,
  "first_name": "erlich",
  "middle_name": "null",
  "last_name": "bachman",
  "email": "erlich@zeal.com",
  "dob": "1998-05-05",
  "phone_number": "4154645367",
  "ein": "12-3456789",
  "business_name": "Monster Cookies",
  "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",
  "instant_pay_enabled": true
}