> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contractor Object

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

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). |

```json theme={null}
{
  "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
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.