Gusto
list_payrolls
Lists all payroll runs for the company with filtering options. When called with no arguments, returns all payrolls (processed and unprocessed, regular, off_cycle, and external) from the past 6 months (start_date defaults to 6 months ago, end_date defaults to today). You can filter results by providing processing_statuses, payroll_types, start_date, end_date, or include parameters. Date filters apply to pay period (work dates), not payment dates. Date range constraints are that the range cannot exceed 1 year, and end_date cannot be more than 3 months in the future. Returns payroll UUIDs, check dates, processing status (processed,unprocessed), and type (regular,off_cycle,external). Use include=totals to get gross pay, taxes, and net amounts. Common use case is to find the next payroll to process by filtering for processing_statuses=unprocessed and selecting the payroll with check_date closest to today's date.
Remote (network-hosted)
Other tools also called list_payrolls?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"include": {
"type": "string",
"description": "Comma-separated: totals, payroll_status_meta, risk_blockers, reversals"
},
"end_date": {
"type": "string",
"description": "Filters where the pay period ends on or before this date (YYYY-MM-DD). Cannot be more than 3 months in the future and must be within 1 year of start_date."
},
"start_date": {
"type": "string",
"description": "Filters where the pay period starts on or after this date (YYYY-MM-DD). Must be within 1 year of end_date."
},
"payroll_types": {
"type": "string",
"description": "Comma-separated: regular,off_cycle,external"
},
"processing_statuses": {
"type": "string",
"description": "Comma-separated: processed,unprocessed"
}
}
}