Justworks · Capability

Justworks Time Off API — Balances, Policies, Requests

Justworks Time Off API. 5 operations. Lead operation: Justworks Create Time Off Balances Report. Asynchronous balance reporting plus policy and request reads.

Justworks Time Off API — Balances, Policies, Requests is a Naftiko capability published by Justworks, one of 6 capabilities the APIs.io network indexes for this provider. It bundles 4 operations.

The capability includes 3 read-only operations and 1 state-changing operation. Lead operation: Justworks Create Time Off Balances Report. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Justworks, Time Off, Leave, and PTO.

Run with Naftiko JustworksTime OffLeavePTO

MCP Tools

justworks-create-time-off-balances-report

Justworks Create Time Off Balances Report

justworks-get-time-off-balances-report

Justworks Get Time Off Balances Report

read-only idempotent

justworks-list-time-off-policies

Justworks List Time Off Policies

read-only idempotent

justworks-list-time-off-requests

Justworks List Time Off Requests

read-only idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Justworks Time Off API — Balances, Policies, Requests
  description: 'Justworks Time Off API. 5 operations. Lead operation: Justworks Create Time Off Balances Report. Asynchronous balance reporting plus policy and request reads.'
  tags:
  - Justworks
  - Time Off
  - Leave
  - PTO
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    JUSTWORKS_ACCESS_TOKEN: JUSTWORKS_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: time-off
    baseUri: https://public-api.justworks.com
    description: Justworks Time Off API business capability.
    resources:
    - name: v1-time-off-balances
      path: /v1/time-off/balances
      operations:
      - name: createtimeoffbalancesreport
        method: POST
        description: Justworks Create Time Off Balances Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-time-off-balances-report_id
      path: /v1/time-off/balances/{report_id}
      operations:
      - name: gettimeoffbalancesreport
        method: GET
        description: Justworks Get Time Off Balances Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-time-off-policies
      path: /v1/time-off/policies
      operations:
      - name: listtimeoffpolicies
        method: GET
        description: Justworks List Time Off Policies
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-time-off-requests
      path: /v1/time-off/requests
      operations:
      - name: listtimeoffrequests
        method: GET
        description: Justworks List Time Off Requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      key: Authorization
      value: 'Bearer {{env.JUSTWORKS_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: time-off-mcp
    port: 9090
    transport: http
    description: MCP adapter for Justworks Time Off API.
    tools:
    - name: justworks-create-time-off-balances-report
      description: Justworks Create Time Off Balances Report
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: time-off.createtimeoffbalancesreport
      outputParameters:
      - type: object
        mapping: $.
    - name: justworks-get-time-off-balances-report
      description: Justworks Get Time Off Balances Report
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: time-off.gettimeoffbalancesreport
      outputParameters:
      - type: object
        mapping: $.
    - name: justworks-list-time-off-policies
      description: Justworks List Time Off Policies
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: time-off.listtimeoffpolicies
      outputParameters:
      - type: object
        mapping: $.
    - name: justworks-list-time-off-requests
      description: Justworks List Time Off Requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: time-off.listtimeoffrequests
      outputParameters:
      - type: object
        mapping: $.