Read employee time-off requests and current PTO balances from a linked HRIS account via Merge's unified Time Off and Time Off Balances endpoints.

Steps

1. Authenticate every request with two headers: Authorization: Bearer <API_KEY> (your Merge account-level key) and X-Account-Token: <account_token> identifying the specific end user's linked HRIS integration.
2. Call GET /api/hris/v1/time-off to list TimeOff records (status, amount, employee reference, start/end dates) for the linked account.
3. Call GET /api/hris/v1/time-off/{id} for a single request, using the expand parameter to inline related objects like the requesting employee.
4. Call GET /api/hris/v1/time-off-balances to list TimeOffBalance records — current PTO/sick balances per employee and policy type.
5. Add include_remote_data=true when you need the original unmapped payload from the underlying HRIS alongside Merge's normalized fields, and show_enum_origins to see a provider's raw enum values instead of Merge's normalized ones.
6. Check the integration's Supported Fields/Supported Features pages (or the /linked-accounts response) before relying on balance data, since coverage varies by which HRIS the end user connected.