v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Time Off Requests

Get time off balances for a company

Get time off balances for all employees in a company

scope: time_off_requests:read

get/v1/companies/{company_uuid}/time_off/balances

Path parameters

company_uuidstring required

The UUID of the company

Query parameters

employee_uuidsstring

Filter by employee UUIDs (comma-separated)

policy_uuidsstring

Filter by time off policy UUIDs (comma-separated)

pageinteger

The page that is requested

perinteger

Number of objects per page

Headers

X-Gusto-API-Version'2026-06-15'

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

Response

successful

employee_uuidstring

The UUID of the employee.

Example response

[
  {
    "employee_uuid": "51924fa0-26c6-4d4c-8832-3ef0b422c67e",
    "balances": [
      {
        "policy_uuid": "c2d9b1bd-3f36-4c2d-a727-b2af057d6a7f",
        "balance_hours": "32.0",
        "accrued_hours": "40.0",
        "used_hours": "8.0",
        "pending_hours": "0.0"
      }
    ]
  }
]