Skip to main content
GET
List employee time off

Authorizations

Authorization
string
header
required

Access token issued by POST /sessions and associated with a valid server-side session.

Path Parameters

id
string<uuid>
required

UUID identifying this resource.

Query Parameters

company_id
string<uuid>
required

Company UUID. Must equal the authenticated session company when that session has a company assigned; the equality check is skipped for sessions without one.

employee_id
string<uuid>

Restrict to one employee UUID.

date_from
string<date>

Inclusive start date in YYYY-MM-DD. Both bounds are optional; see operation defaults.

date_to
string<date>

Inclusive end date in YYYY-MM-DD. Both bounds are optional; see operation defaults.

page
integer
default:1

One-based page number.

Required range: x >= 1
per_page
integer
default:100

Items per page; values greater than 500 are clamped to 500.

Required range: x >= 1

Response

Successful response.

balance
integer<int64>
required
balance_change
integer<int64>
required
effective_time
string
required
employee_id
string
required

Employee id.

event_description
string
required
event_type
string
required
policy_name
string
required
time_off_type
string
required