Reads all Reference contracts

get https://api.factorialhr.com/api/2025-04-01/resources/contracts/reference_contracts

Reads all Reference Contracts. The reference contract is the contract that applies today. If no contract applies today, we will return the nearest upcoming contract. If there are no upcoming contracts, we will provide the most recent past contract.

Response

Response body

array of objects

object

integer

identifier for the contract version.

company_id

integer

required

identifier for company.

employee_id

integer

required

employee identifier, refers to /employees/employees endpoint.

effective_on

string

required

the day the specific contract starts, in case of hiring the same than starts_on.

country

string

nationality country code of the employee (Spain ES, United Kingdom GB).

job_title

string

job title of the employee.

job_catalog_level

string

the level of the employee in the job catalog.

job_catalog_role

string

the role of the employee in the job catalog.

starts_on

string

the day the employee is hired.

ends_on

string

the day the employee is terminated.

has_payroll

boolean

required

boolean that indicates if the employee asociated to this contract belongs to a payroll policy.

has_trial_period

boolean

a flag that indicates if the employee has a trial period.

trial_period_ends_on

string

when the trial period ends.

salary_amount

integer

the amount of money the employee earns.

salary_frequency

string

the frequency of the salary payment.

working_week_days

string

the days of the week the employee works.

working_hours

integer

the amount of hours the employee works.

working_hours_frequency

string

the frequency of the working hours.

max_legal_yearly_hours

integer

the maximum amount of hours the employee can work in a year.

maximum_weekly_hours

integer

the maximum amount of hours the employee can work in a week.

bank_holiday_treatment

string

required

Defines whether a bank holiday should be considered as a workable or non-workable day.

workable non_workable

working_time_percentage_in_cents

integer

Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).

min_rest_minutes_between_days

integer

the minimum amount of minutes the employee must rest between working periods.

max_work_minutes_per_day

integer

the maximum amount of minutes the employee can work in a day.

max_work_days_in_row

integer

the maximum amount of days the employee can work in a row.

min_rest_hours_in_row

integer

the minimum amount of hours the employee must rest in a row.

created_at

string

required

the date the contract version was created.

updated_at

string

required

the date of the last contract version updated.

es_has_teleworking_contract

boolean

flag that indicates if the contract has teleworking.

es_cotization_group

integer

the group of cotization of the employee.

contracts_es_tariff_group_id

integer

the group of cotization of the employee.

es_contract_observations

string

observations of the contract.

es_job_description

string

the job description of the employee.

es_contract_type_id

integer

contract type identifier.

es_working_day_type_id

integer

working day type identifier.

es_education_level_id

integer

education level identifier.

es_professional_category_id

integer

professional category identifier.

fr_employee_type

string

employee type.

fr_forfait_jours

boolean

required

flag that indicates if the employee is allowed to work within the framework of a fixed number of days.

fr_jours_par_an

integer

the number of days the employee is allowed to work.

fr_coefficient

string

coefficient for france contracts.

fr_contract_type_id

integer

contract type identifier.

fr_level_id

integer

level identifier.

fr_step_id

integer

step identifier.

fr_mutual_id

integer

mutual identifier.

fr_professional_category_id

integer

professional category identifier.

fr_work_type_id

integer

work type identifier.

de_contract_type_id

integer

contract type identifier.

pt_contract_type_id

integer

contract type identifier.

Language

Credentials

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.factorialhr.com/api/2025-04-01/resources/contracts/reference_contracts \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK