jethr_create_absence_request

Create a leave, sickness, remote-work or other presence/absence request for an employee. WRITES to the company's HR records. codename is the request kind (from jethr_list_absence_policies); give start_date and end_date for day requests, or start_date + start_time + time_duration for hourly requests. send_notification=true makes Jet HR notify the people involved (approvers/employee) and needs confirm_notification=true; default false. Some kinds need extra fields (child data, trip data, sickness certificate): Jet HR answers with a validation error naming them. POST /public-api/v1/presence-absence-requests/.

Argument	Type	Description
puc	string	Sickness only: the PUC protocol number.
note	string	Note on the request.
codename*	string	Request kind codename (from jethr_list_absence_policies), e.g. HOLIDAY.
employee*	string	Employee uuid (from jethr_list_employees).
end_date	string	Last day (yyyy-mm-dd); omit for a single day.
child_ssn	string	Child fiscal code (required for FEEDING, SICKNESS_CHILD_CHILD, SICKNESS_CHILD_INFANT).
trip_name	string	Trip policy name (required for TRIP_* kinds; see jethr_list_trip_refund_policies).
start_date	string	First day (yyyy-mm-dd).
start_time	string	Start time HH:MM, hourly requests only.
assisted_ssn	string	Fiscal code of the assisted person (kinds that need it, e.g. Law 104 leave).
time_duration	string	Duration HH:MM, hourly requests only.
child_birth_date	string	Child birth date (required for PARENTAL_PATERNAL_MANDATORY_LEAVE).
send_notification	boolean	Notify the people involved (default false); needs confirm_notification=true.
confirm_notification	boolean	Must be true when send_notification is true: the user approved that Jet HR notifies the people involved.
trip_meals_reimbursed	boolean	TRIP_* kinds: meals are reimbursed.
sickness_justification_type	string	Sickness only: PUC protocol number or paper certificate.
donor_transfusion_center_ssn	string	Donor leave only: fiscal code of the transfusion center.
trip_accommodation_reimbursed	boolean	TRIP_* kinds: accommodation is reimbursed.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "employee",
    "codename"
  ],
  "properties": {
    "puc": {
      "type": "string",
      "maxLength": 100,
      "description": "Sickness only: the PUC protocol number."
    },
    "note": {
      "type": "string",
      "maxLength": 2000,
      "description": "Note on the request."
    },
    "codename": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Request kind codename (from jethr_list_absence_policies), e.g. HOLIDAY."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Employee uuid (from jethr_list_employees)."
    },
    "end_date": {
      "type": "string",
      "description": "Last day (yyyy-mm-dd); omit for a single day."
    },
    "child_ssn": {
      "type": "string",
      "maxLength": 32,
      "description": "Child fiscal code (required for FEEDING, SICKNESS_CHILD_CHILD, SICKNESS_CHILD_INFANT)."
    },
    "trip_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Trip policy name (required for TRIP_* kinds; see jethr_list_trip_refund_policies)."
    },
    "start_date": {
      "type": "string",
      "description": "First day (yyyy-mm-dd)."
    },
    "start_time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
      "description": "Start time HH:MM, hourly requests only."
    },
    "assisted_ssn": {
      "type": "string",
      "maxLength": 32,
      "description": "Fiscal code of the assisted person (kinds that need it, e.g. Law 104 leave)."
    },
    "time_duration": {
      "type": "string",
      "pattern": "^\\d{1,3}:\\d{2}(:\\d{2})?$",
      "description": "Duration HH:MM, hourly requests only."
    },
    "child_birth_date": {
      "type": "string",
      "description": "Child birth date (required for PARENTAL_PATERNAL_MANDATORY_LEAVE)."
    },
    "send_notification": {
      "type": "boolean",
      "description": "Notify the people involved (default false); needs confirm_notification=true."
    },
    "confirm_notification": {
      "type": "boolean",
      "const": true,
      "description": "Must be true when send_notification is true: the user approved that Jet HR notifies the people involved."
    },
    "trip_meals_reimbursed": {
      "type": "boolean",
      "description": "TRIP_* kinds: meals are reimbursed."
    },
    "sickness_justification_type": {
      "enum": [
        "PUC",
        "PAPER_CERTIFICATE"
      ],
      "type": "string",
      "description": "Sickness only: PUC protocol number or paper certificate."
    },
    "donor_transfusion_center_ssn": {
      "type": "string",
      "maxLength": 32,
      "description": "Donor leave only: fiscal code of the transfusion center."
    },
    "trip_accommodation_reimbursed": {
      "type": "boolean",
      "description": "TRIP_* kinds: accommodation is reimbursed."
    }
  }
}

jethr_create_expense

Create an expense reimbursement request for an employee (no receipt files; those are uploaded in Jet HR). WRITES to the company's records as a reimbursement request. amount is the EUR amount; amount_total is the amount in amount_total_currency (the same value for EUR). POST /public-api/v1/expenses/.

Argument	Type	Description
kind*	string	Expense kind: FOOD, TRAVELS, KM, TELECOM, HOTELS, DEVICES, SERVICES, OTHER, CUSTOM.
note	string	Note.
amount*	string	Amount in EUR, e.g. 49.90.
car_km	integer	Mileage (KM) only: kilometres driven.
subkind	string	Sub-kind of the expense, if the policy has one.
employee*	string	Employee uuid (from jethr_list_employees).
car_brand	string	Mileage (KM) only: vehicle make.
car_cost_km	string	Mileage (KM) only: cost per km in EUR, e.g. 0.4521.
description*

jethr_delete_absence_request

Permanently delete a presence/absence request (it disappears from the employee's calendar and balance). Cannot be undone; needs confirm=true. DELETE /public-api/v1/presence-absence-requests/{uuid}/.

destructive

Argument	Type	Description
id*	string	Request uuid (from jethr_list_absence_requests).
confirm*	boolean	Must be true: the user approved permanently deleting this request.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "confirm"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Request uuid (from jethr_list_absence_requests)."
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true: the user approved permanently deleting this request."
    }
  }
}

jethr_get_absence_request_kind

One absence request kind setting: codename, whether it needs approval or a note, whether it can be requested in hours or days, duration limits. GET /public-api/v1/company-absence-request-kinds/{uuid}/.

read-only

Argument	Type	Description
id*	string	Request kind uuid (from jethr_list_absence_policies, absence_kinds_settings).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Request kind uuid (from jethr_list_absence_policies, absence_kinds_settings)."
    }
  }
}

jethr_get_contractor

One contractor with their collaborations. GET /public-api/v1/contractors/{uuid}/.

read-only

Argument	Type	Description
id*	string	Contractor uuid (from jethr_list_contractors).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Contractor uuid (from jethr_list_contractors)."
    }
  }
}

jethr_get_device

One company device with its assignment. GET /public-api/v1/devices/{uuid}/.

read-only

Argument	Type	Description
id*	string	Device uuid (from jethr_list_devices).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Device uuid (from jethr_list_devices)."
    }
  }
}

jethr_get_employee

One employee's full record (contract, salary, manager, headquarters, custom fields). GET /public-api/v1/employees/{uuid}/.

read-only

Argument	Type	Description
id*	string	Employee uuid (from jethr_list_employees).
as_of_date	string	Resolve the employee's data as of this date (yyyy-mm-dd) instead of today.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Employee uuid (from jethr_list_employees)."
    },
    "as_of_date": {
      "type": "string",
      "description": "Resolve the employee's data as of this date (yyyy-mm-dd) instead of today."
    }
  }
}

jethr_get_employee_overview

One employee's overview record (job title, contract dates, manager, headquarters, custom fields). GET /public-api/v1/employee-overviews/{uuid}/.

read-only

Argument	Type	Description
id*	string	Employee uuid (from jethr_list_employee_overviews).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Employee uuid (from jethr_list_employee_overviews)."
    }
  }
}

jethr_get_hiring

One hiring process with its status and data. GET /public-api/v1/hirings/{uuid}/.

read-only

Argument	Type	Description
id*	string	Hiring uuid (from jethr_list_hirings).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Hiring uuid (from jethr_list_hirings)."
    }
  }
}

jethr_list_absence_policies

List the company's absence policies with their active request kinds (codename, name, approval and attachment rules) and the employees assigned to each. The codename is what jethr_create_absence_request needs. Paged: pass next_page as page. GET /public-api/v1/company-absence-policies/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_absence_requests

List leave, sickness, remote-work and other presence/absence requests with status (APPROVED, REJECTED, PENDING), kind, dates, hours, note and approver. Filters combine with AND. Use status filtering on the result for pending requests. Paged: pass next_page as page. GET /public-api/v1/presence-absence-requests/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
codename	string	Request kind codename, e.g. HOLIDAY or SICKNESS (see jethr_list_absence_policies).
employee	string	Only this employee (uuid from jethr_list_employees).
created_to	string	Only requests created at or before this timestamp.
end_date_to	string	Only requests ending on or before this date (yyyy-mm-dd).
created_from	string	Only requests created at or after this timestamp.
end_date_from	string	Only requests ending on or after this date (yyyy-mm-dd).
start_date_to	string

jethr_list_bonus_kinds

List the bonus kinds (categories) the company can use in payroll. Paged: pass next_page as page. GET /public-api/v1/bonus-kinds/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_bonuses

List payroll bonuses (employee, payroll month, amount, kind, note), optionally for one employee, year or month. Paged: pass next_page as page. GET /public-api/v1/bonuses/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
year	integer	Payslip year, e.g. 2026.
employee	string	Only this employee (uuid from jethr_list_employees).
monthly_pay	integer	Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1990,
      "description": "Payslip year, e.g. 2026."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this employee (uuid from jethr_list_employees)."
    },
    "monthly_pay": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them)."
    }
  }
}

jethr_list_clockings

List time-clock events (in, out, work and break start/end, overtime) with employee, timestamp, method (web, mobile, badge, QR code), workplace and location. Paged: pass next_page as page. GET /public-api/v1/clockings/.

read-only

Argument	Type	Description
kind	string	Only this clocking kind.
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
method	string	Only this clocking method.
employee	string	Only this employee (uuid from jethr_list_employees).
clocked_to	string	Only clockings at or before this timestamp.
created_to	string	Only clockings created at or before this timestamp.
clocked_from	string	Only clockings at or after this timestamp.
created_from	string	Only clockings created at or after this timestamp.

Input schema (JSON)

jethr_list_company_ccnl

List the national collective labour agreements (CCNL) the company applies. Paged: pass next_page as page. GET /public-api/v1/company-ccnl/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_company_headquarters

List the company's headquarters (legal and operative sites), optionally by kind. Paged: pass next_page as page. GET /public-api/v1/company-headquarters/.

read-only

Argument	Type	Description
kind	string	Only legal or only operative headquarters.
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "enum": [
        "LEGAL",
        "OPERATIVE"
      ],
      "type": "string",
      "description": "Only legal or only operative headquarters."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_contractors

List external contractors (collaborators) and their collaborations, optionally filtered by contractor, linked employee or a collaboration date window. Paged: pass next_page as page. GET /public-api/v1/contractors/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
employee_uuid	string	Only contractors linked to this employee.
contractor_uuid	string	Only this contractor.
collaboration_date_to	string	Only collaborations overlapping this date or earlier (yyyy-mm-dd).
collaboration_date_from	string	Only collaborations overlapping this date or later (yyyy-mm-dd).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "employee_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only contractors linked to this employee."
    },
    "contractor_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this contractor."
    },
    "collaboration_date_to": {
      "type": "string",
      "description": "Only collaborations overlapping this date or earlier (yyyy-mm-dd)."
    },
    "collaboration_date_from": {
      "type": "string",
      "description": "Only collaborations overlapping this date or later (yyyy-mm-dd)."
    }
  }
}

jethr_list_devices

List company devices (laptops, phones...) and the employee each is assigned to, optionally by employee or device uuid. Paged: pass next_page as page. GET /public-api/v1/devices/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
uuid	string	Only this device uuid.
employee	string	Only this employee (uuid from jethr_list_employees).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this device uuid."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this employee (uuid from jethr_list_employees)."
    }
  }
}

jethr_list_documents

List documents stored in Jet HR (payslips, contracts and other files): metadata per document, optionally by employee, kind name, payroll period or last-update window. Paged: pass next_page as page. GET /public-api/v1/documents/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
period	string	Only documents of the payroll of this month (YYYY-MM).
employee	string	Only this employee (uuid from jethr_list_employees).
kind_name	string	Only documents of this kind name.
updated_after	string	Only documents updated at or after this timestamp.
updated_before	string	Only documents updated at or before this timestamp.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "period": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
      "description": "Only documents of the payroll of this month (YYYY-MM)."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this employee (uuid from jethr_list_employees)."
    },
    "kind_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only documents of this kind name."
    },
    "updated_after": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})$",
      "description": "Only documents updated at or after this timestamp."
    },
    "updated_before": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})$",
      "description": "Only documents updated at or before this timestamp."
    }
  }
}

jethr_list_employee_overviews

List employees with the lighter overview record: name, fiscal code, work email, job title, contract dates, probation end, manager, headquarters and custom fields (no salary or personal contact data). Needs only the employee_overview:read scope. Paged: pass next_page as page. GET /public-api/v1/employee-overviews/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_employees

List the company's employees with the full record: name, fiscal code, work and personal email, job title and level, contract kind and dates, annual gross salary (RAL), manager, headquarters and custom fields. Contains personal data; for a lighter list use jethr_list_employee_overviews. Paged: pass next_page as page. GET /public-api/v1/employees/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
as_of_date	string	Resolve the employee's data as of this date (yyyy-mm-dd) instead of today.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "as_of_date": {
      "type": "string",
      "description": "Resolve the employee's data as of this date (yyyy-mm-dd) instead of today."
    }
  }
}

jethr_list_expense_policies

List the company's expense policies (which expense kinds and limits apply to which employees). Paged: pass next_page as page. GET /public-api/v1/company-expense-policies/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_expenses

List expense reimbursement requests (employee, amount, currency, kind, description, payment date, receipts, status). Paged: pass next_page as page. GET /public-api/v1/expenses/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_fringe_benefit_kinds

List the fringe benefit kinds (categories) available in payroll. Paged: pass next_page as page. GET /public-api/v1/fringe-benefit-kinds/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_fringe_benefits

List fringe benefits assigned in payroll (employee, payroll month, amount, kind), optionally for one employee, year or month. Paged: pass next_page as page. GET /public-api/v1/fringe-benefits/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
year	integer	Payslip year, e.g. 2026.
employee	string	Only this employee (uuid from jethr_list_employees).
monthly_pay	integer	Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1990,
      "description": "Payslip year, e.g. 2026."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this employee (uuid from jethr_list_employees)."
    },
    "monthly_pay": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them)."
    }
  }
}

jethr_list_hirings

List hiring processes (drafts and onboarding in progress), optionally by status (for example INCOMPLETE or COMPLETED). Paged: pass next_page as page. GET /public-api/v1/hirings/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
status	string	Only hirings in this status.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "status": {
      "enum": [
        "AWAITING_EXTERNAL_PROVIDER_VERIFICATION",
        "AWAITING_JET_ACTIVATION",
        "COMPLETED",
        "CONTRACT_AWAITING_EMPLOYEE_DATA",
        "CONTRACT_AWAITING_SIGNATURE",
        "CUSTOM_CONTRACT_AWAITING_EMPLOYEE_DATA",
        "INCOMPLETE",
        "IN_CHARGE_TO_JET",
        "OFFER_LETTER_AWAITING_SIGNATURE",
        "PENDING_HIRING_FORM"
      ],
      "type": "string",
      "description": "Only hirings in this status."
    }
  }
}

jethr_list_payrolls

List the company's monthly payrolls (year and month, status and totals). Sensitive financial data. Paged: pass next_page as page. GET /public-api/v1/payrolls/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
year	integer	Payslip year, e.g. 2026.
monthly_pay	integer	Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1990,
      "description": "Payslip year, e.g. 2026."
    },
    "monthly_pay": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them)."
    }
  }
}

jethr_list_payslip_extra_deduction_kinds

List the extra deduction kinds (categories) available on payslips. Paged: pass next_page as page. GET /public-api/v1/payslip-extra-deduction-kinds/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_payslip_extra_deductions

List extra deductions applied to payslips (employee, payroll month, amount, kind), optionally for one employee, year or month. Paged: pass next_page as page. GET /public-api/v1/payslip-extra-deductions/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
year	integer	Payslip year, e.g. 2026.
employee	string	Only this employee (uuid from jethr_list_employees).
monthly_pay	integer	Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1990,
      "description": "Payslip year, e.g. 2026."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this employee (uuid from jethr_list_employees)."
    },
    "monthly_pay": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them)."
    }
  }
}

jethr_list_payslips

List employee payslips, optionally for one employee, year or month. Sensitive payroll data. Paged: pass next_page as page. GET /public-api/v1/payslips/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.
year	integer	Payslip year, e.g. 2026.
employee	string	Only this employee (uuid from jethr_list_employees).
monthly_pay	integer	Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    },
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1990,
      "description": "Payslip year, e.g. 2026."
    },
    "employee": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this employee (uuid from jethr_list_employees)."
    },
    "monthly_pay": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "Payslip monthly pay: month number 1-12 (13 and 14 for the extra monthly payments, tredicesima and quattordicesima, where the company has them)."
    }
  }
}

jethr_list_terminations

List employee terminations (resignations and dismissals recorded in Jet HR). Paged: pass next_page as page. GET /public-api/v1/terminations/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_list_trip_refund_policies

List the company's business-trip daily refund policies (needed as trip_name for trip absence requests). Paged: pass next_page as page. GET /public-api/v1/company-trip-daily-refund-policies/.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use next_page from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
    }
  }
}

jethr_update_absence_request

Change a presence/absence request: dates, hours, note, or its status (APPROVED, REJECTED, PENDING; give rejection_reason when rejecting). WRITES to the company's HR records; approving or rejecting is visible to the employee, and send_notification=true notifies the people involved (default false; needs confirm_notification=true). Only the fields you pass change. PATCH /public-api/v1/presence-absence-requests/{uuid}/.

destructive

Argument	Type	Description
id*	string	Request uuid (from jethr_list_absence_requests).
puc	string	Sickness only: the PUC protocol number.
note	string	New note.
status	string	New status.
end_date	string \| null	New last day (yyyy-mm-dd); null clears it.
start_date	string \| null	New first day (yyyy-mm-dd); null clears it.
start_time	any	New start time HH:MM, hourly requests only; null clears it.
assisted_ssn	string	Fiscal code of the assisted person (kinds that need it, e.g. Law 104 leave).

Jet HR MCP by usefulapi

Try it

jethr_create_absence_request

Jet HR MCP by usefulapi

Try it

jethr_create_absence_request

Tools (33)