Rippling: List payroll-runs — response body — results item

API reference · Contract 2026-10-28

SDK schema: List payroll-runs — response body — results item

Field	Type	Presence	Description and constraints
$	object	Root	V2 DTO representing a single payroll run. Used by: - GET /payroll-runs/ (list) - GET /payroll-runs/{id} (retrieve)
approval_deadline	string	Optional	Deadline for approving the payroll run.
approved_at	string	Optional	Timestamp when the run was approved.
check_date	string	Optional	Date the paycheck is issued.
company_entity_id	string	Optional	Identifier linking this payroll run to the company’s legal entity in the HRIS system.
country_code	string	Optional	ISO country code where the payroll run applies.
debit_date	string	Optional	Date funds are debited from the company’s account.
id	string	Optional	Unique identifier for the payroll run.
lock_deadline	string	Optional	Deadline after which the run is locked for changes.
paid_at	string	Optional	Timestamp when the run was marked as paid.
pay_period	object	Optional	Pay period details for this run.
pay_period.end_date	string	Optional	End date of the pay period.
pay_period.pay_frequency	string	Optional	Pay frequency for this period (e.g. BI_WEEKLY, SEMI_MONTHLY, MONTHLY, WEEKLY).
pay_period.start_date	string	Optional	Start date of the pay period.
payment_type	string	Optional	Payment method used (e.g. WIRE, ACH).
run_state	string	Optional	Current state of the run (e.g. DRAFT, PAID, APPROVED).
run_type	string	Optional	Type of the run (e.g. REGULAR, OFF_CYCLE, CORRECTION).
title	string	Optional	Human-readable title of the payroll run.