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": {}
}| Attribute | Description |
|---|---|
idstring | Unique identifier for the employee. |
first_namestring | Employee's first name. |
middle_namestring | Employee's middle name. |
last_namestring | Employee's last name. |
emailstring | Employee's email address. |
dobYYYY-MM-DD | Employee’s date of birth. |
bank_accountsarray of strings | Read only. An array of bank account IDs for the employee. |
ssn_last_fourstring | The last four digits of the employee’s SSN or TIN. |
ssn_validation_statusstring | 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_preferencestring | Either manual or direct_deposit if the employee has a linked bank account. |
activeboolean | 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. |
onboardobject | Structured information about the onboard status of the employee. |
workplacesarray of strings | IDs of workplaces where the employee works. |
primary_workplacestring | ID of the employee's primary workplace. |
companystring | ID of employee's company. |
start_dateYYYY-MM-DD | Most recent start date of employment. To cancel an employee who never started, see Start and termination dates. |
termination_dateYYYY-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_splitstring | ID of the net pay split currently active on the employee |
residenceobject | Employee’s residence. |
mailing_addressobject | Mailing address for paper correspondence. Separate from residence and not used for tax calculations. Pass null to clear. |
w2_electronic_consent_providedboolean | Indicates whether the employee has opted into electronic delivery of W2 PDF. |
metadataobject | 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
400error ontermination_datewith the message "Termination date cannot be earlier than the start date.", and nothing in the request is saved. Atermination_dateon or after thestart_dateis valid, including a date in the future. - To rehire an employee, clear the old termination date. Send the new
start_datewithtermination_date: nullin the same request. If a request movesstart_datepast the existingtermination_datewithout clearing it, it returns a400error ontermination_datewith the message "To rehire, send termination_date: null with the new start date." - To cancel an employee who never started, send
active: falseandstart_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 needsstart_date: null. If the employee has atermination_date, also sendtermination_date: null, because a termination date requires a start date. For any other employee, unsettingstart_datereturns a400error onstart_datewith 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.

