GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

List time off requests for a company

get
https://api.gusto-demo.com/v1/companies//time_off/requests

Get all time off requests for a company. Supports filtering by status, employee, and date ranges.

Possible statuses:

  • pending — awaiting approval
  • approved — approved by an admin but not yet processed in a payroll
  • declined — declined by an admin
  • consumed — processed in a completed payroll

scope: time_off_requests:read

Path Params
string
required

The UUID of the company

Query Params
string

Filter by employee UUIDs. Comma-separated for multiple values.

string

Filter by request status. Comma-separated for multiple values (e.g. pending,approved,declined,consumed).

string

Filter requests that overlap with this start date

string

Filter requests that overlap with this end date

string

Sort order by start_date (asc or desc, defaults to desc)

integer

The page that is requested

integer

Number of objects per page

Headers
string
enum
Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:
Responses

Updated 2 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago