GuidesAPI ReferenceChangelogAPI PolicyAPI StatusGusto Security

Get pay periods for a company

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

Language
Authorization
Bearer
URL
Click Try It! to start a request and see the response here!