Cancel a payroll

PUT {{baseUrl}}/v1/companies/:company_id/payrolls/:payroll_id/cancel

Transitions a processed payroll back to the unprocessed state. A payroll can be canceled if it meets both criteria: - processed is true - Current time is earlier than 3:30pm PT on the payroll_deadline

scope: payrolls:run

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Acceptstring

RESPONSES

status: OK

{"payroll_deadline":"2021-02-18T22:00:00Z","check_date":"2021-02-22","off_cycle":false,"external":false,"processed":false,"processed_date":null,"calculated_at":null,"payroll_uuid":"b50e611d-8f3d-4f24-b001-46675f7b5777","company_uuid":"6bf7807c-a5a0-4f4d-b2e7-3fbb4b2299fb","created_at":"2022-02-01T22:00:00Z","pay_period":{"start_date":"2021-02-01","end_date":"2021-02-15","pay_schedule_uuid":"00ebc4a4-ec88-4435-8f45-c505bb63e501"},"payroll_status_meta":{"cancellable":false,"expected_check_date":"2021-02-22","initial_check_date":"2021-02-22","expected_debit_time":"2021-02-18T22:00:00Z","payroll_late":false,"initial_debit_cutoff_time":"2021-02-18T22:00:00Z"},"submission_blockers":[{"blocker_type":"fast_ach_threshold_exceeded","blocker_name":"Fast ACH Threshold Exceeded","unblock_options":[{"unblock_type":"wire_in","check_date":"2024-06-10","metadata":{"wire_in_deadline":"2024-06-19T18:00:00Z","wire_in_amount":400000}},{"unblock_type":"move_to_four_day","check_date":"2024-06-12","metadata":{}}],"selected_option":null,"status":"unresolved"}]}