The contractor object

Represents an individual or a business that receives non-employee compensation from a company.

When including contractors in payroll, Check will automatically file all associated 1099 forms.

{
    "id": "ctr_CyQIKSp6YvU6mBe2a6iq",
    "type": "individual",
    "company": "com_EkIJ9RewumnQLODHv1vl",
    "workplaces": [
        "wrk_ZquJLY48hvpLDSTT6JBn"
    ],
    "primary_workplace": "wrk_ZquJLY48hvpLDSTT6JBn",
    "first_name": "Bruce",
    "middle_name": "Frederick Joseph",
    "last_name": "Springsteen",
    "business_name": null,
    "dob": "1970-05-29",
    "start_date": "2019-03-01",
    "termination_date": null,
    "email": "[email protected]",
    "bank_accounts": ["bnk_rLXONRICxgyyeUaS16"],
    "ssn_last_four": "0000",
    "ssn_validation_status": "validated",
    "ein": null,
    "default_net_pay_split": "nps_lk218jk9082mjkjljT1c",
    "payment_method_preference": null,
    "onboard": {
        "status": "needs_attention",
        "blocking_steps": [],
        "remaining_steps": [
            "payment_method"
        ],
        "payment_method": [
            "payment_method_preference_set",
            "bank_account_exists",
            "bank_account_verified",
        ],
    },
    "address": {
        "line1": "913 Ocean Ave",
        "line2": null,
        "city": "Asbury Park",
        "state": "NJ",
        "postal_code": "07712",
        "country": "US"
    },
    "1099_nec_electronic_consent_provided": false,
  	"metadata": {}
}
AttributeDescription
id
string
Unique identifier for the contractor.
type
string
individual if the contractor is a person. business if not a person.
company
string
ID of the company the contractor performs work for.
workplaces
array of strings
IDs of workplaces where the contractor works.
primary_workplace
string
ID of the contractor's primary workplace.
first_name
string
Contractor's first name. If contractor type is business, a primary contact is needed for 1099 filing so use the first name of the business's primary contact.
middle_name
string
Contractor's middle name. If contractor type is business, a primary contact is needed for 1099 filing so use the middle name of the business's primary contact, if it exists.
last_name
string
Contractor's last name. If contractor type is business, a primary contact is needed for 1099 filing so use the last name of the business's primary contact.
business_name
string
Contractor's business name if they are a business entity.
dob
YYYY-MM-DD
Contractor's date of birth.
start_date
YYYY-MM-DD
Most recent start date of contract.
termination_date
YYYY-MM-DD
Most recent termination date of contract. Will be set to null if a more recent start date is set.
email
string
Contractor's email address.
bank_accounts
array of strings
Read only. An array of bank account IDs.
ssn_last_four
string
The last four digits of the contractor’s SSN.
ssn_validation_status
string
The validation status of the employee's SSN. Either pending indicating validation in progress, validated indicating passing our validation criteria, or invalid indicating the ssn is not valid.
ein
string
Contractor's Employer Identification Number.
default_net_pay_split
string
ID of the net pay split currently active on the contractor.
onboard
object
Structured information about the onboard status of the contractor.
address
object
Legal address of contractor on file with the federal government. If the contractor has a type of business, then you should use the address of the business.
payment_method_preference
string
Either manual or direct_deposit if the contractor has a linked bank account.
1099_nec_electronic_consent_provided
boolean
Indicates whether the contractor has opted into electronic delivery of Copy B of 1099-NEC.
metadata
object
Additional loosely structured information to associate with the contractor.