Get a single payroll

GET {{baseUrl}}/v1/companies/:company_id/payrolls/:payroll_id?include=<string>

Returns a payroll. If payroll is calculated or processed, will return employee_compensations and totals.

Notes: * Hour and dollar amounts are returned as string representations of numeric decimals. * Hours are represented to the thousands place; dollar amounts are represented to the cent. * Every eligible compensation is returned for each employee. If no data has yet be inserted for a given field, it defaults to “0.00” (for fixed amounts) or “0.000” (for hours ). * To return future payrolls, you must include an end_date in the future. * To return future payrolls, you must include an end_date in the future. * When include parameter with benefits value is passed, employeebenefits:read scope is required to return benefits * Benefits containing PHI are only visible with the `employeebenefits:read:phi` scope

scope: payrolls:read

Request Params

KeyDatatypeRequiredDescription
includestringInclude the requested attribute in the response, for multiple attributes comma separate the values, i.e. ?include=benefits,deductions,taxes

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

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