The employee object

Represents a person who receives compensation for a job performed at a company.

{
    "id": "emp_zGGp6wYcxAeu1Ng8IA7v",
    "first_name": "Tony",
    "last_name": "Stark",
    "middle_name": null,
    "email": "[email protected]",
    "dob": "1970-05-29",
    "bank_accounts": [],
    "ssn_last_four": null,
    "ssn_validation_status": null,
    "payment_method_preference": null,
    "active": true,
    "onboard": {
        "status": "needs_attention",
        "blocking_steps": [],
        "remaining_steps": [
            "ssn",
            "payment_method",
            "withholdings",
        ],
        "ssn": [
            "ssn_submitted",
            "ssn_validated",
        ],
        "payment_method": [
            "payment_method_preference_set",
            "bank_account_exists",
            "bank_account_verified",
        ],
        "withholdings": [
            {
                "id": "jur_kSO0VneVfdx5TDDQ9Xnp",
                "name": "Federal",
              	"status": "needs_attention",
            },
            {
                "id": "jur_CUlTApePRnDFn9bPVCQE",
                "name": "New York", 
              	"status": "needs_attention",
            },  
        ]
    },
    "workplaces": [
        "wrk_i8nfu8234r8dkjhzlsdv"
    ],
    "primary_workplace": "wrk_i8nfu8234r8dkjhzlsdv",
    "company": "com_sx3svU6K8c5ZkSFlOh5p",
    "start_date": "2019-03-01",
    "termination_date": null, 
    "default_net_pay_split": "nps_lk218jk9082mjkjljT1c",
    "residence": {
        "line1": "630 Bedford Road",
        "line2": null,
        "city": "Tarrytown",
        "state": "NY",
        "postal_code": "10591",
        "country": "US"
    },
    "mailing_address": null,
    "w2_electronic_consent_provided": false,
    "metadata": {}
}
AttributeDescription
id
string
Unique identifier for the employee.
first_name
string
Employee's first name.
middle_name
string
Employee's middle name.
last_name
string
Employee's last name.
email
string
Employee's email address.
dob
YYYY-MM-DD
Employee’s date of birth.
bank_accounts
array of strings
Read only. An array of bank account IDs for the employee.
ssn_last_four
string
The last four digits of the employee’s SSN or TIN.
ssn_validation_status
string
The validation status of the employee's SSN. Either pending indicating validation in progress, validated indicating the SSN passes our validation criteria, or invalid indicating the SSN is not valid. For more details see SSN Validation .
payment_method_preference
string
Either manual or direct_deposit if the employee has a linked bank account.
active
boolean
Indicates whether the employee is currently employed. Used only for filtering: active decides whether an employee is returned by the active filter on List employees and whether they appear in Console lists, not whether they can be paid. active and termination_date are set independently, so setting termination_date does not require setting active to false. To pay an employee after their last day, see Off-cycle Payrolls. Sending active: false with start_date: null also cancels an employee who never started. See Start and termination dates.
onboard
object
Structured information about the onboard status of the employee.
workplaces
array of strings
IDs of workplaces where the employee works.
primary_workplace
string
ID of the employee's primary workplace.
company
string
ID of employee's company.
start_date
YYYY-MM-DD
Most recent start date of employment. To cancel an employee who never started, see Start and termination dates.
termination_date
YYYY-MM-DD
Most recent date of employment termination. Must be null, or on or after start_date, which must be set. To rehire, send termination_date: null with the new start_date. See Start and termination dates.
default_net_pay_split
string
ID of the net pay split currently active on the employee
residence
object
Employee’s residence.
mailing_address
object
Mailing address for paper correspondence. Separate from residence and not used for tax calculations. Pass null to clear.
w2_electronic_consent_provided
boolean
Indicates whether the employee has opted into electronic delivery of W2 PDF.
metadata
object
Additional loosely structured information to associate with the employee.

Start and termination dates

Starting November 19, 2026, Check enforces these rules on every API version. They apply to Create an employee, including bulk create, and Update an employee whenever the request sends start_date or termination_date. A request that sends neither date is not checked against them.

  • A termination date can't be earlier than the start date. The request returns a 400 error on termination_date with the message "Termination date cannot be earlier than the start date.", and nothing in the request is saved. A termination_date on or after the start_date is valid, including a date in the future.
  • To rehire an employee, clear the old termination date. Send the new start_date with termination_date: null in the same request. If a request moves start_date past the existing termination_date without clearing it, it returns a 400 error on termination_date with the message "To rehire, send termination_date: null with the new start date."
  • To cancel an employee who never started, send active: false and start_date: null. This works only for an employee who has no payroll items on any payroll, including a draft payroll. An employee who is already inactive only needs start_date: null. If the employee has a termination_date, also send termination_date: null, because a termination date requires a start date. For any other employee, unsetting start_date returns a 400 error on start_date with the message "Cannot unset start date after it's been set".
{
    "start_date": "2026-03-02",
    "termination_date": null
}
{
    "active": false,
    "start_date": null
}

Before November 19, 2026, Check accepts a termination_date earlier than the start_date with a success response but saves termination_date as null, even when the employee already had a valid termination date. A request that moves start_date past the existing termination_date also clears it. Before that date, an employee's start_date can't be unset.