Get pay periods for a company

GET {{baseUrl}}/v1/companies/:company_id/pay_periods?start_date=<string>&end_date=<string>&payroll_types=<string>

Pay periods are the foundation of payroll. Compensation, time & attendance, taxes, and expense reports all rely on when they happened. To begin submitting information for a given payroll, we need to agree on the time period.

By default, this endpoint returns every current and past pay period for a company. Since companies can process payroll as often as every week, there can be up to 53 pay periods a year. If a company has been running payroll with Gusto for five years, this endpoint could return up to 265 pay periods. Use the start_date and end_date parameters to reduce the scope of the response.

scope: payrolls:read

Request Params

KeyDatatypeRequiredDescription
start_datestring
end_datestringIf left empty, defaults to today's date.
payroll_typesstringregular and/or transition. Multiple options are comma separated. The default is regular pay periods if nothing is passed in.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

[{&quot;start_date&quot;:&quot;2020-01-11&quot;,&quot;end_date&quot;:&quot;2020-01-24&quot;,&quot;pay_schedule_id&quot;:1409756036510222,&quot;pay_schedule_uuid&quot;:&quot;00ebc4a4-ec88-4435-8f45-c505bb63e501&quot;,&quot;eligible_employees&quot;:[{&quot;id&quot;:7740244452464965,&quot;uuid&quot;:&quot;26c2359e-78d3-4450-b2e4-661e2a655a17&quot;,&quot;job_ids&quot;:[7740244454306064],&quot;job_uuids&quot;:[&quot;7d01ef7b-5ef5-4d73-aaac-148789fa79ad&quot;]},{&quot;id&quot;:7757869431131641,&quot;uuid&quot;:&quot;9fde3f01-c7e8-4a65-95ec-1e5a74549e61&quot;,&quot;job_ids&quot;:[7757869439389315],&quot;job_uuids&quot;:[&quot;618dac73-5450-4045-865d-8168e0863ce6&quot;]}],&quot;payroll&quot;:{&quot;processed&quot;:true,&quot;payroll_deadline&quot;:&quot;2020-01-28&quot;,&quot;payroll_type&quot;:&quot;regular&quot;}},{&quot;start_date&quot;:&quot;2020-12-12&quot;,&quot;end_date&quot;:&quot;2020-12-25&quot;,&quot;pay_schedule_id&quot;:1409756036510224,&quot;pay_schedule_uuid&quot;:&quot;cb53db72-612f-4eb1-9b85-389e79cfa510&quot;,&quot;eligible_employees&quot;:[{&quot;id&quot;:1409722316858016,&quot;uuid&quot;:&quot;699f4da3-a032-4c87-b33a-02b1efffa494&quot;,&quot;job_ids&quot;:[1409722316881160],&quot;job_uuids&quot;:[&quot;ac05c860-8fc4-4fa7-a949-bee924379bb6&quot;]},{&quot;id&quot;:7757869431131645,&quot;uuid&quot;:&quot;7a03c791-cc99-48e6-85f2-26d4b6d26b62&quot;,&quot;job_ids&quot;:[7757869439389316],&quot;job_uuids&quot;:[&quot;0e66ad7d-33a4-4f40-aa94-eff3ee5a7812&quot;]}],&quot;payroll&quot;:{&quot;processed&quot;:true,&quot;payroll_deadline&quot;:&quot;2020-12-28&quot;,&quot;payroll_type&quot;:&quot;regular&quot;}}]