Error codes

Below is a list of error codes that Check may return in the type field, along with information on how to resolve them.

Error code

Description

address_invalid

Invalid address. Update the address and try again.

api_error

An internal error occurred. We have been notified and are looking into the issue.

contractor_payment_already_exists

Only one contractor payment can be created per contractor per payroll.

employee_benefit_already_exists

Only one employee benefit can be created per employee per benefit type. Update the existing benefit type if you need to adjust contribution amounts.

net_pay_negative

Net pay was calculated to be negative. Contact us if you encounter this.

non_empty_payroll_required

Payrolls must have at least one item or contractor payment to be previewed or approved.

non_managed_payroll_update_invalid

Non-managed payrolls cannot be updated as they were not managed and paid via Check. Contact us if you need to update a non-managed item.

non_managed_payroll_void_invalid

Non-managed payrolls cannot be voided as they were not managed and paid via Check. Contact us if you need to void a non-managed item.

not_authenticated

Authentication credentials were not provided.

not_found

The resource you're looking for was not found, or you do not have permission to access it.

off_cycle_options_invalid

Only payrolls of type 'off_cycle' can have 'off_cycle_options'.

payroll_approval_deadline_expired

Payroll is past approval deadline without approval, and further changes are not allowed. If you want to pay employees by payday, they must all be paid with the "manual" payment method.

payroll_already_approved

Payroll is already approved, and further changes are not allowed. If changes need to be made before the approval deadline, you can reopen the payroll.

payroll_date_invalid

Invalid payroll period or payday.

payroll_item_already_exists

Only one payroll item can be created per employee per payroll.

payroll_item_limit_exceeded

Payroll items are limited to 100 in sandbox.

payroll_reopening_invalid

Only payrolls in the 'pending' status can be reopened.

permission_denied

You do not have permission to perform this action.

post_tax_deduction_invalid

The post tax deduction to be created or updated is invalid. Refer to the post-tax deduction object specification to determine the correct configuration.

routing_number_invalid

Invalid ABA routing number. Update it to be a valid ABA routing number and try again.

start_date_invalid

Invalid payday start date for paydays list endpoint.

state_not_supported

You have tried to create a company, employee, or workplace in a state that is not currently supported by Check. Contact Check if a state you require is not yet supported via the API.

throttled

You made too many requests to the API. See the accompanying message for when to attempt requests again.

unapproved_payroll_void_invalid

Payroll items of unapproved payrolls cannot be voided. Instead, update the previous payroll.

validation_error

The request body contained invalid data. Look at the message and optional input_errors for more information to resolve.

voided_payroll_reopening_invalid

Cannot reopen a payroll with voided item or voided contractor payment. Contact us if you need to reopen a voided item.

void_already_exists

A payroll item can only be voided once.

void_invalid

A void payroll item cannot be voided.

company_tax_setup_required

Company tax setup must be complete.