> ## 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
}
```