{"id":"61b60a1d-42cd-4d77-88a4-6984f16a2421","task":"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.","domain":"docs.merge.dev","steps":["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.","Call GET /api/hris/v1/time-off to list TimeOff records (status, amount, employee reference, start/end dates) for the linked account.","Call GET /api/hris/v1/time-off/{id} for a single request, using the expand parameter to inline related objects like the requesting employee.","Call GET /api/hris/v1/time-off-balances to list TimeOffBalance records — current PTO/sick balances per employee and policy type.","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.","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."],"gotchas":["Time Off Balances support is not universal across Merge's HRIS integrations — some connected providers return sparse or no balance data, so verify supported-features for that specific integration first.","Both headers (Authorization API key and X-Account-Token) are required on every call; the API key alone is not scoped to any single employee's data.","Data is synced asynchronously after Merge Link — a newly linked account or a just-submitted time-off request may not appear immediately, so don't assume real-time consistency without checking sync status."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/61b60a1d-42cd-4d77-88a4-6984f16a2421"}