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