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	One of: `individual_sole_proprietor`, `c_corporation`, `s_corporation`, `partnership`, `trust_estate`, `llc`, `other`
`llc_tax_classification`	enum	One of: `c_corporation` (default), `s_corporation`, `partnership` (only applicable if `type` is `llc`)
`tin_type`	enum	One of: `ssn`, `ein` (if `ein` is passed, the `ein` field is 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 `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 yet. 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. Only applicable for Paycards (Early Access).
`kyc_status`	enum	One of: `null`, `approved`, `denied`
`ssn_verification_status`	enum	One of: `null`, `approved`, `declined`
`instant_pay_enabled`	boolean	Set to `true` if the contractor has completed instant pay enrollment. Only applicable for Instant Pay (Early Access).

{
  "contractorID": "c9f1e2a47d3b4f8a9c2e1a6b8d4f3e21",
  "companyID": "a7e3c91f4b2d8f5e9c6a1d0b4e8f2c73",
  "onboarded": true,
  "type": "c_corporation",
  "tin_type": null,
  "first_name": "erlich",
  "middle_name": null,
  "last_name": "bachman",
  "email": "erlich@aviato.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
}

Introduction

Webhooks

Zeal Components

Companies

Company Onboarding

Reserve Accounts

Customer Accounts (Early Access)

Taxable Locations

Work Locations

Employees

Employee Deduction Templates

Employee Onboarding

Bank Accounts

Custom Attributes

Paperwork API

Employee Checks

Contractors

Contractor Onboarding

Contractor Payment Deductions

Payment Items

Contractor Payments

Paycards

Instant Pay

Employer Checks

Preview

Embedded HR

Reports

Documents