GET
/
employer
/
time-off-events
Time-Off Events
curl --request GET \
  --url https://api.tryfinch.com/employer/time-off-events \
  --header 'Authorization: Bearer <token>' \
  --header 'Finch-API-Version: <finch-api-version>'
[
  {
    "id": "e1f2a3b4-c5d6-7e8f-9a0b-1c2d3e4f5a6b",
    "source_id": "vacation_req_123",
    "individual_id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
    "reviewer_id": "c205b3fa-b626-4346-bf0f-ca065ab88d31",
    "status": "approved",
    "policy_type": "pto",
    "source_policy_type": "Vacation",
    "event_type": "vacation",
    "source_event_type": "Annual Leave",
    "start_date": "2024-07-15T00:00:00",
    "end_date": "2024-07-19T23:59:59"
  }
]

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string
default:2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Query Parameters

​
individual_id
string

Filter by individual employee ID

​
policy_type
enum<string>

Filter by policy type

Available options:
pto,
sick,
parental,
unpaid,
other

Response

200
application/json

Time-off events for employees

Array of time-off events for employees.