Generate and poll a Justworks time off balance report via the Partner API

domain: hr-payroll · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Ensure your token carries the time_off:read scope
  2. POST to the time off balance report endpoint with an optional member_id, policy_id, and as_of_date to scope the report
  3. Read the report_id from the response
  4. Poll GET on the report-by-ID endpoint and check the status field (e.g., pending) until the report is ready
  5. Read available and used amounts per member/policy from the returned items, along with each policy's unit_type (e.g., minutes)

Known gotchas

Related routes

Create, update, and cancel member payroll deductions via the Justworks Partner API
hr-payroll · 5 steps · unrated
Retrieve payroll runs, paystubs, and deductions for a company via the Justworks Partner API using scoped tokens
public-api.justworks.com · 5 steps · unrated
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.
docs.merge.dev · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans