v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Contracts > ContractVersionHistory

Reads a single Contract version history

get/api/2026-07-01/resources/contracts/contract_version_histories/{id}

Path parameters

idstring required

the ids of the contract versions.

Response

idstring required

identifier for the contract version history.

employee_idstring required

employee identifier, refers to /employees/employees endpoint.

effective_onstring required

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

countrystring

nationality country code of the employee.

job_titlestring

job title of the employee.

job_catalog_level_idstring

job catalog level identifier, refers to /job_catalog/levels endpoint.

job_catalog_tree_node_uuidstring

the uuid node in the job catalog tree. For now it only supports level nodes. From this point in the job catalog tree you can get the full ancestor path to the root node including the role. Refer to job_catalog/tree_nodes endpoint.

starts_onstring

the day the employee is hired.

ends_onstring

the day the employee is terminated.

has_payrollboolean required

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

salary_amountinteger

the amount of money the employee earns in cents.

salary_frequencystring

the frequency of the salary payment.

working_week_daysstring

the days of the week the employee works.

working_hoursinteger

the amount of hours the employee works.

working_hours_frequencystring

the frequency of the working hours.

max_legal_yearly_hoursinteger

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

maximum_weekly_hoursinteger

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

original_contract_version_idstring required

identifier for the original contract version.

contracts_contract_version_idstring

identifier for the current contract version.

changed_atstring required

the date the contract version was changed.

trial_period_ends_onstring

when the trial period ends.

has_trial_periodboolean

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

authorstring

the author of the contract version change.

action_typestring

the type of action that was performed on the contract version.

adjusted_daily_minutesinteger

adjusted daily minutes for the employee.

created_atstring required

the date the contract version was created.

updated_atstring required

the date of the last contract version updated.

es_has_teleworking_contractboolean

spanish boolean that indicates if the employee has a teleworking contract.

es_cotization_groupinteger

spanish cotization group identifier.

es_contract_observationsstring

spanish observations of the contract.

es_job_descriptionstring

spanish job description of the contract.

es_contract_type_idstring

spanish contract type identifier.

es_working_day_type_idstring

spanish working day type identifier.

es_education_level_idstring

spanish education level identifier.

es_professional_category_idstring

spanish professional category identifier.

es_contribution_type_idstring

spanish contribution type identifier.

es_agreement_code_idstring

spanish agreement code identifier.

es_cno_occupation_idstring

spanish cno occupation identifier.

es_tariff_group_idstring

spanish tariff group identifier.

es_occupation_code_idstring

spanish occupation code identifier.

es_classification_idstring

spanish classification identifier.

fr_employee_typestring

french employee type.

fr_forfait_joursboolean required

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

fr_jours_par_aninteger

french number of days the employee is allowed to work.

fr_jours_par_an_centsinteger

french number of days the employee is allowed to work in cents.

fr_coefficientstring

french coefficient for france contracts.

fr_contract_type_idstring

french contract type identifier.

fr_level_idstring

french level identifier.

fr_step_idstring

french step identifier.

fr_mutual_idstring

french mutual identifier.

fr_professional_category_idstring

french professional category identifier.

fr_work_type_idstring

french work type identifier.

de_contract_type_idstring

german contract type identifier.

de_base_salary_type_idstring

Identifier for the German base salary type. References a payroll concept available via the /payroll/concepts endpoint.

pt_contract_type_idstring

portuguese contract type identifier.

Example response

{
  "id": "1",
  "employee_id": "1",
  "effective_on": "2024-10-06",
  "country": "es",
  "job_title": "Designer",
  "job_catalog_level_id": "1",
  "job_catalog_tree_node_uuid": "jobcatalog_treelevel-14",
  "starts_on": "2024-10-06",
  "ends_on": "2024-10-06",
  "salary_amount": 1000,
  "salary_frequency": "yearly",
  "working_week_days": "monday,tuesday,wednesday,thursday,friday",
  "working_hours": 40,
  "working_hours_frequency": "week",
  "max_legal_yearly_hours": 2000,
  "maximum_weekly_hours": 40,
  "original_contract_version_id": "1",
  "contracts_contract_version_id": "1",
  "changed_at": "2024-10-06T00:00:00.000Z",
  "trial_period_ends_on": "2024-10-06",
  "author": "John Doe",
  "action_type": "promotion",
  "adjusted_daily_minutes": 480,
  "created_at": "2024-10-06",
  "updated_at": "2024-10-06",
  "es_cotization_group": 1,
  "es_contract_observations": "Observations",
  "es_job_description": "Job description",
  "es_contract_type_id": "1",
  "es_working_day_type_id": "1",
  "es_education_level_id": "1",
  "es_professional_category_id": "1",
  "es_contribution_type_id": "1",
  "es_tariff_group_id": "1",
  "es_occupation_code_id": "1",
  "fr_employee_type": "apprenti",
  "fr_jours_par_an": 200,
  "fr_jours_par_an_cents": 20000,
  "fr_coefficient": "1",
  "fr_contract_type_id": "1",
  "fr_level_id": "1",
  "fr_step_id": "1",
  "fr_mutual_id": "1",
  "fr_professional_category_id": "1",
  "fr_work_type_id": "1",
  "de_contract_type_id": "1",
  "de_base_salary_type_id": "1",
  "pt_contract_type_id": "1"
}