List all deductions

GET/hris/{connection_id}/deduction

Parameters

limitnumber default=100
offsetnumber default=0
updated_gtedate
Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
sort enum
order enum
querystring
Query string to search. eg. email address or name
user_idstring
The user/employee ID to filter by (reference to HrisEmployee)
company_idstring
The company ID to filter by (reference to HrisCompany)
payslip_idstring
The payslip ID to filter by
benefit_idstring
The benefit ID to filter by
start_gtestring
The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
end_ltstring
The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
fieldsstring array
Fields to return
rawstring
Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar
connection_idstring required
ID of the connection

Returns

Employee-specific deduction/benefit enrolment.

idstring
created_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
updated_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
user_idstring
employee ID (reference to HrisEmployee)
company_idstring
(reference to HrisCompany)
benefit_idstring
amountnumber
percentage or absolute amount (employee's portion)
type enum
Valid values:
"FIXED"
"PERCENTAGE"
coverage_level enum
Valid values:
"EMPLOYEE_ONLY"
"EMPLOYEE_SPOUSE"
"EMPLOYEE_CHILD"
"EMPLOYEE_CHILDREN"
"EMPLOYEE_FAMILY"
Level selected by employee (e.g. "FAMILY", "EMPLOYEE_ONLY", or other)
frequency enum
Valid values:
"ONE_TIME"
"DAY"
"QUARTER"
"YEAR"
"HOUR"
Frequency for this deduction (should always be set, matches IHrisBenefit.frequency)
start_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
end_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
is_activeboolean
notesstring
const options = {
  method: 'GET',
  url: 'https://api.unified.to/hris/5de520f96e439b002043d8dc/deduction',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    limit: 50,
    offset: 0,
    updated_gte: '2026-07-04T01:53:36.739Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    user_id: '',
    company_id: '',
    payslip_id: '',
    benefit_id: '',
    start_gte: '',
    end_lt: '',
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);
Are we missing anything? Let us know
Was this page helpful?