GET
/
employer
/
time-off-balances
Time-Off Balances
curl --request GET \
  --url https://api.tryfinch.com/employer/time-off-balances \
  --header 'Authorization: Bearer <token>' \
  --header 'Finch-API-Version: <finch-api-version>'
[
  {
    "individual_id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
    "policy_type": "pto",
    "source_policy_type": "Vacation",
    "balance": 120,
    "units": "hours",
    "accrued": 160,
    "used": 40
  },
  {
    "individual_id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
    "policy_type": "sick",
    "source_policy_type": "Sick Leave",
    "balance": 32,
    "units": "hours",
    "accrued": 40,
    "used": 8
  }
]

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 balances for employees

Array of time-off balances for employees.