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",
    "first_name": "Bruce",
    "middle_name": "Frederick Joseph",
    "last_name": "Springsteen",
    "business_name": null,
    "email": "[email protected]",
    "bank_accounts": ["bnk_rLXONRICxgyyeUaS16"],
    "ssn_last_four": "0000",
    "ein": null,
    "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": {}
}

Attribute

Description

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.

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.

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.

ein
string

Contractor's Employer Identification Number.

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.